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 / chsfld.cli / readme.txt < prev    next >
Encoding:
Text File  |  1996-07-28  |  1.6 KB  |  30 lines
  1. MAPI Choose Folder Sample
  2.  
  3. Copyright (c) 1886-1996 Microsoft Corporation. All Rights Reserved.
  4.  
  5.  
  6. This samples illustrates implementing a MAPI Container hierarchy viewer.
  7. It uses standard WIN32 Tree View Control to display folder hierarchy of
  8. a message store and to allow a user to choose a particular folder.
  9. Chsfld32.dll exports a single entry point  HrPickFolder. Please see
  10. chsfld.h located in common directory for the exact description of
  11. arguments and return values.
  12.  
  13. The use of HrPickFolder is straightforward: just pass in all the required
  14. parameters and, assuming that everything goes OK, get back pointers to
  15. IMAPIFolder interface of the folder chosen by the user and a pointer to
  16. IMsgStore interface of the message store that contains the folder.
  17. There are to optional parameters. If you use them (meaning they are not
  18. zeroes), the function will save the expand/collapse state of the dialog
  19. at the moment the user pressed "OK". If you pass this parameter back next
  20. time you call HrPickFolder, the dialog will restore the saved state. See
  21. route.cli and simple.frm samples for the example on how to use the function.
  22.  
  23. If you want to use the function as is, in a separate DLL, all you need to
  24. do is to link with chsfld32.dll either statically or dynamically and call
  25. the function. To reuse the source code, you will have to modify it a bit.
  26. You have to make sure that the HINSTANCE parameter that you pass to
  27. CChsFldDlg constructor in function HrPickFolder (file chsfld.cpp) is the
  28. handle of the executable module that contains the resources used by the
  29. class (the dialog and the icons).
  30.