Platform SDK: MAPI |
The HrComposeEID function creates 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 |
HrComposeEID( LPMAPISESSION psession, ULONG cbStoreRecordKey, LPBYTE pStoreRecordKey, ULONG cbMsgEID, LPENTRYID pMsgEID, ULONG FAR * pcbEID, LPENTRYID FAR * ppEID );
If the message or other object for which the compound entry identifier is being created resides in a message store, the identifier 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 cbStoreRecordKey is zero, the object's entry identifier is simply copied.
The HrComposeEID function, primarily for use with CMC, enables CMC-based applications to work with objects in multiple stores through the use of compound entry identifiers. An application can call the HrDecomposeEID function to split the compound entry identifier into its original constituents.
Entry Identifier Functions, HrComposeMsgID, HrDecomposeMsgID