home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / vc98 / include / mspst.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-04-25  |  4.9 KB  |  96 lines
  1. /*
  2.  *  M S P S T . H
  3.  *  
  4.  *  This file lists internal properties of the Microsoft Personal
  5.  *  Information Store
  6.  *  
  7.  *  Copyright 1986-1996 Microsoft Corporation. All Rights Reserved.
  8.  */
  9.  
  10. #ifndef _MSPST_H_
  11. #define _MSPST_H_
  12.  
  13.  
  14. /*  The following is a list of properties that may be passed in
  15.     as the properties in the array of SPropValue structure on the
  16.     MsgServiceConfigure function.
  17.     
  18.     Creating a PST profile section through CreateMsgService.
  19.     The creation of the actual PST file is a two step process.  First the
  20.     client should call CreateMsgService to setup the profile section and then
  21.     ConfigureMsgService to create the PST file.
  22.     The CreateMsgService call will setup the PR_DISPLAY_NAME property in the
  23.     profile section to be used on the PST when it is created.
  24.  
  25.     Configuring an PST file through ConfigureMsgService.
  26.     The configuration of an PST can take two forms, either configuring an
  27.     existing PST or creating a new PST.  The Microsoft Personal Information
  28.     Store provider will try to find the necessary properties by first looking
  29.     in the array of SPropValue structures provided by the client and then in the
  30.     profile section, except for PR_PST_PW_SZ_OLD for which it will only look
  31.     in the array of properties.
  32.  
  33.     The Microsoft PST provider will try to open the file specified by the
  34.     PR_PST_PATH property, using the password given in the PR_PST_PW_SZ_OLD
  35.     property.  If it finds a file and it recognizes it as a PST
  36.     file, it will start the configuration routine.  Otherwise it will start the
  37.     creation routine.
  38.  
  39.     The configuration routine will look for the PR_DISPLAY_NAME_A and
  40.     PR_COMMENT_A properties and set them in the message store object.  Then it
  41.     will look for the PR_PST_REMEMBER_PW property to decide if it should
  42.     remember the password in the profile. (If not found then it will defaut to
  43.     the current status of the profile password.)  Then if it is supposed to
  44.     use UI, it will display the configuration property sheet to the user.  After
  45.     all has succeeded, it will update the profile.
  46.  
  47.     The creation routine will follow one of two paths to get the PR_PST_PATH
  48.     property.  If it is supposed to use UI it will always display the file open
  49.     dialog to confirm the path passed in or allow the user to change it.  If
  50.     the user chooses an existing file and it recognizes it as an PST it will
  51.     drop back to the configuration routine.  If the user chooses an existing
  52.     file and it is not recognized as an PST file, the user will be given the
  53.     option of choosing another file or  creating a new PST in its place, in
  54.     which case is will continue with the create routine.  If the user chooses
  55.     a new file it will continue with the create routine.  If the routine is not
  56.     allowed to use UI, then the routine will create a file at the given path
  57.     even if another file exists there.
  58.  
  59.     Once it decides to continue with the creation process it will get the
  60.     PR_DISPLAY_NAME, PR_COMMENT, PR_PST_ENCRYPTION, and PR_PST_SZ_PW_NEW
  61.     properties.  If it is supposed to use UI, it will use these to initialize
  62.     the creation dialog and get any changes the user want.  Then it will create
  63.     a new file and update the profile.
  64.     
  65.     PR_DISPLAY_NAME_A   display name for the PST service
  66.     PR_COMMENT_A        comment to the place on the PST store object
  67.     PR_PST_PATH         location the store to create or configure
  68.     PR_PST_REMEMBER_PW  whether or not the remember the password in the profile
  69.     PR_PST_ENCRYPTION   encryption level at which to create the file
  70.     PR_PST_PW_SZ_OLD    password of the PST being configured
  71.     PR_PST_PW_SZ_NEW    password to use for future access to the PST
  72. */
  73.  
  74. #define PST_EXTERN_PROPID_BASE          (0x6700)
  75. #define PR_PST_PATH                     PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 0)
  76. #define PR_PST_REMEMBER_PW              PROP_TAG(PT_BOOLEAN, PST_EXTERN_PROPID_BASE + 1)
  77. #define PR_PST_ENCRYPTION               PROP_TAG(PT_LONG, PST_EXTERN_PROPID_BASE + 2)
  78. #define PR_PST_PW_SZ_OLD                PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 3)
  79. #define PR_PST_PW_SZ_NEW                PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 4)
  80.     
  81. #define PSTF_NO_ENCRYPTION              ((DWORD)0x80000000)
  82. #define PSTF_COMPRESSABLE_ENCRYPTION    ((DWORD)0x40000000)
  83. #define PSTF_BEST_ENCRYPTION            ((DWORD)0x20000000)
  84.  
  85. /*
  86.  *  PR_MDB_PROVIDER is the GUID that represent the Microsoft Personal
  87.  *  Information Store.  This guid is available as a property in the stores
  88.  *  table and on the message store and status objects.
  89.  */
  90. #define MSPST_UID_PROVIDER  {   0x4e, 0x49, 0x54, 0x41, \
  91.                                 0xf9, 0xbf, 0xb8, 0x01, \
  92.                                 0x00, 0xaa, 0x00, 0x37, \
  93.                                 0xd9, 0x6e, 0x00, 0x00 }
  94.  
  95. #endif  /* _MSPST_H_ */
  96.