Export (0) Print
Expand All

IMAPISupport::WrapStoreEntryID

Last modified: July 23, 2011

Applies to: Outlook

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
);

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.

S_OK

The entry identifier was successfully wrapped.

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.

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.

Show:
© 2014 Microsoft