Platform SDK: Exchange Server

HrMAPICloseCachedProp

The HrMAPICloseCachedProp function copies the properties in a local cached object back to the original remote object, if the object was created as a write cache.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB

HRESULT HrMAPICloseCachedProp(
  LPPROPDATA lpCachedObj,                  
  LPMAPIPROP lpOriginalObj,                
  ULONG ulFlags,                           
  LPSPropProblemArray  FAR * lpp Problems  
);
 

Parameters

lpCachedObj
Input parameter. Points to a MAPI IPropData interface containing the cached property object.
lpOriginalObj
Input parameter. Points to a MAPI IMAPIProp interface containing the original object.
ulFlags
Input parameter. Defined values that control the cache type:
EDK_CACHE_READ
EDK_CACHE_WRITE
lppProblems
Output parameter. Points to a MAPI SPropProblemArray structure containing information about problems setting properties on the original object.

Return Values

See Return Values.

Remarks

The calling application is responsible for releasing the local MAPI IMAPIProp object when it is finished using it. lppProblems may be set, even though the overall call is successful. This is because all of the SetProps have been deferred on the original object until this call. The user must evaluate the contents of the lppProblems buffer pointer based on which properties were set.

For more information on this function, see the HrMAPICloseCachedProp function in IPROP.C under the EDKMAPI code sample in the Code Samples folder.

For information on the IMAPIProp interface, SPropProblemArray structure, and SPropValue structure, see the MAPI Programmer's Reference.

See Also

HrMAPIOpenCachedProp