IMAPISupport::WrapStoreEntryID
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Converts a message store's internal entry identifier to an entry identifier in the MAPI standard format.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Parameters
cbOrigEntry
[in] The byte count in the entry identifier pointed to by the lpOrigEntry parameter.lpOrigEntry
[in] A pointer to the private entry identifier for the message store.lpcbWrappedEntry
[out] A pointer to the byte count in the entry identifier pointed to by the lppWrappedEntry parameter.lppWrappedEntry
[out] A pointer to a pointer to the wrapped entry identifier.
Return Value
- S_OK
The entry identifier was successfully wrapped.
Remarks
The IMAPISupport::WrapStoreEntryID method is implemented for all service provider support objects. Service providers use WrapStoreEntryID to have MAPI generate an entry identifier for a message store that wraps the store's internal entry identifier.
Notes to Callers
When a client calls your message store's IMAPIProp::GetProps method to retrieve its PR_STORE_ENTRYID (PidTagStoreEntryId) property, and your message store uses an entry identifier in a private format, call WrapStoreEntryID and return the entry identifier pointed to by the lppWrappedEntry parameter.
Calls to the IMSProvider::Logon and IMSLogon::CompareEntryIDs methods always obtain the store's private entry identifier; the wrapped version is used only between client applications and MAPI.
Free the memory for the entry identifier pointed to by the lppWrappedEntry parameter by using the MAPIFreeBuffer function when you are finished using the entry identifier.