home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Internet 2000 May / MICD_2000_05.iso / CBuilder5 / INSTALL / DATA1.CAB / Program_Built_Files / Include / newpst.h < prev    next >
C/C++ Source or Header  |  2000-02-01  |  3KB  |  83 lines
  1. // --newpst.h-----------------------------------------------------------------
  2. //
  3. // Header file for the newpst library.
  4. //
  5. // Copyright 1986 - 1998 Microsoft Corporation.  All rights reserved.
  6. //
  7. //-----------------------------------------------------------------------------
  8.  
  9. #ifndef    _NEWPST_H
  10. #pragma option push -b -a8 -pc -A- /*P_O_Push*/
  11. #define _NEWPST_H
  12.  
  13. #ifdef  __cplusplus
  14. extern "C" {
  15. #endif
  16.  
  17. // $--HrCreatePersonalStore----------------------------------------------------------
  18. //
  19. // DESCRIPTION: Create a New PST with properties determined by the input
  20. //                parameters in a temporary profile.  The name and password
  21. //                of the temporary PST are returned to the user.
  22. //
  23. // INPUT:
  24. //
  25. //    [lpszPSTPath]            -- Value for PR_PST_PATH (new PST path).
  26. //    [dwEncryption]            -- Value for PR_PST_ENCRYPTION (TBS).
  27. //    [lpszPSTDisplayName]    -- Value for PR_DISPLAY_NAME (new PST display name).
  28. //    [lpszPSTPassword]        -- Value for PR_PST_PW_SZ_NEW (new PST password,
  29. //                               NULL not accepted).
  30. //
  31. // OUTPUT:
  32. //
  33. //    [lppszProfileName]        -- Ptr that will be set to point at temporary
  34. //                               profile name on return; this may be used to
  35. //                               establish a MAPI session.
  36. //    [lppszProfilePassword]    -- Ptr that will be set to point at temporary
  37. //                               profile password on return; this may be used to
  38. //                               establish a MAPI session.
  39. //
  40. // RETURNS:     NOERROR on success,
  41. //              E_INVALIDARG if bad input,
  42. //              E_ACCESSDENIED if can't access profile,
  43. //              E_FAIL if general failure
  44. //
  45. // Notes:        Successive calls to CreateNewPST() should not be made without
  46. //                intervening calls to NewPSTCleanup().  Due to use of internal
  47. //                static storage for objects and profile strings, only one new
  48. //                PST may be created and used at a time.
  49. //
  50. //---------------------------------------------------------------------------
  51.  
  52. HRESULT HrCreatePersonalStore(                         // RETURNS: HRESULT
  53.     IN    LPSTR    lpszPSTPath,            // PST fully-pathed file name
  54.     IN    DWORD    dwEncryption,           // encryption method
  55.     IN    LPSTR    lpszPSTDisplayName,     // PR_DISPLAY_NAME value
  56.     IN    LPSTR    lpszPSTPassword,        // PST password
  57.     OUT    LPSTR *    lppszProfileName,       // Temporary profile name
  58.     OUT    LPSTR *    lppszProfilePassword    // Temporary profile password
  59.     );
  60.  
  61. // $--HrCleanupPSTGlobals---------------------------------------------------------
  62. //
  63. // DESCRIPTION: Release objects involved in creation of a new PST.
  64. //
  65. // INPUT:       temporary profile name
  66. //
  67. // RETURNS:     NOERROR on success
  68. //              E_FAIL on failure
  69. //
  70. // Notes:        This should be called after Logoff() and Release() are called
  71. //                for the LPSESSION and before MAPIUninitialize() is called.
  72. //---------------------------------------------------------------------------
  73.  
  74. HRESULT HrCleanupPSTGlobals(         // RETURNS: HRESULT
  75.         IN LPSTR lpszProfileName);  // temporary profile name
  76.  
  77. #ifdef  __cplusplus
  78. }       /*  extern "C" */
  79. #endif
  80.  
  81. #pragma option pop /*P_O_Pop*/
  82. #endif    // _NEWPST_H
  83.