Share via


IMAPISupport::WrapStoreEntryID

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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.

See Also

Reference

IMAPIProp::GetProps

IMAPISupport::CompareEntryIDs

IMSLogon::CompareEntryIDs

IMSProvider::Logon

MAPIFreeBuffer

IMAPISupport : IUnknown