home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / dbmsg / mapi / common / chsfld.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-04-11  |  2.1 KB  |  63 lines
  1. ////////////////////////////////////////////////////////////////////////////
  2. //
  3. //      CHSFLD.H
  4. //
  5. //      Prototype for HrPickFolder.
  6. //      Displays a dialog box allowing user to choose a folder from message
  7. //      stores in the current profile.
  8. //
  9. //  Copyright 1986-1996 Microsoft Corporation. All Rights Reserved.
  10. ////////////////////////////////////////////////////////////////////////////
  11.  
  12. #ifdef _WIN32
  13.  
  14. #ifndef _CHSFLD_H_
  15. #define _CHSFLD_H_
  16.  
  17. // Parameters:
  18. // 
  19. // required:
  20. //
  21. // hInst    - [in] instance of the module containing resources for the dialog
  22. //
  23. // hWnd     - [in] handle of the parent window for the dialog 
  24. //
  25. // pses     - [in] pointer to MAPI session object
  26. //
  27. // ppfld    - [out] on success points to the variable where a pointer to the
  28. //                  selected folder is stored
  29. //
  30. // ppmdb    - [out] on success points to the variable where a pointer to a
  31. //                  message store object containing the selected folder is stored
  32. //
  33. // optional:
  34. //
  35. // pcb      - [in/out] size of the buffer pointed to by *ppb
  36. //
  37. // ppb      - [in/out] *ppb is a pointer to the buffer where expand/collapse
  38. //                      state of the dialog is stored. (don't mess with it).
  39. //                      The state is valid only within the same MAPI session.
  40. //
  41. // Return Values:
  42. //
  43. // S_OK     - The call succeeded and has returned the expected values
  44. //
  45. // E_INVALIDARG - One or more of the parameters passed into the function
  46. //                  were not valid
  47. //
  48. // MAPI_E_USER_CANCEL   - User canceled the dialog
  49.  
  50. STDAPI HrPickFolder(HINSTANCE hInst, HWND hWnd, LPMAPISESSION pses,
  51.                     LPMAPIFOLDER * ppfld, LPMDB * ppmdb,
  52.                     ULONG *pcb, LPBYTE *ppb);
  53.                         
  54. typedef   HRESULT (STDAPICALLTYPE * HRPICKFOLDER)(HINSTANCE hInst, HWND hWnd,
  55.                     LPMAPISESSION pses, LPMAPIFOLDER * ppfld, LPMDB * ppmdb,
  56.                     ULONG *pcb, LPBYTE *ppb);
  57.  
  58. #define szChsFldDllName "chsfld32.dll"
  59. #define szChsFldFnName "HrPickFolder"
  60.  
  61. #endif /* _CHSFLD_H_ */
  62. #endif /* _WIN32 */
  63.