Platform SDK: MAPI |
The HrComposeMsgID function creates an ASCII string representing a compound entry identifier for an object, usually a message in a message store.
Note This function may not be supported in future versions of MAPI.
Header file: | MAPIUTIL.H |
Implemented by: | MAPI |
Called by: | Client applications |
HrComposeMsgID( LPMAPISESSION psession, ULONG cbStoreRecordKey, LPBYTE pStoreRecordKey, ULONG cbMsgEID, LPENTRYID pMsgEID, LPTSTR FAR * pszMsgID );
If the message or other object for which the compound entry identifier is being created resides in a message store, the identifier string is created from the object's entry identifier and the store's record key. If the object is not in a store, that is, if the byte count for the store record key passed in the cbStoreRecordKey parameter is zero, the object's entry identifier is simply copied and converted into a string.
Calling the HrComposeMsgID function is equivalent to calling the HrComposeEID function and then the HrSzFromEntryID function.
HrComposeMsgID enables client applications based on Simple MAPI and OLE to work with objects in multiple stores through the use of compound entry identifiers. An application can call the HrDecomposeMsgID function to split the compound entry identifier into its original constituents.