IMAPISupport::WrapStoreEntryID
Область применения: Outlook 2013 | Outlook 2016
Преобразует внутренний идентификатор записи хранилища сообщений в идентификатор записи в стандартном формате MAPI.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Параметры
cbOrigEntry
[в] Число байтов в идентификаторе записи, на который указывает параметр lpOrigEntry .
lpOrigEntry
[в] Указатель на идентификатор частной записи для хранилища сообщений.
lpcbWrappedEntry
[out] Указатель на число байтов в идентификаторе записи, на который указывает параметр lppWrappedEntry .
lppWrappedEntry
[out] Указатель на указатель на идентификатор записи в оболочке.
Возвращаемое значение
S_OK
Идентификатор записи успешно упакован.
Замечания
Метод IMAPISupport::WrapStoreEntryID реализован для всех объектов поддержки поставщика услуг. Поставщики услуг используют WrapStoreEntryID для создания MAPI идентификатора записи для хранилища сообщений, которое содержит внутренний идентификатор записи хранилища.
Примечания для вызывающих методов
Когда клиент вызывает метод IMAPIProp::GetProps хранилища сообщений для получения свойства PR_STORE_ENTRYID (PidTagStoreEntryId), а хранилище сообщений использует идентификатор записи в закрытом формате, вызовите WrapStoreEntryID и верните идентификатор записи, на который указывает параметр lppWrappedEntry.
Вызовы методов IMSProvider::Logon и IMSLogon::CompareEntryIDs всегда получают идентификатор частной записи хранилища; оболочка используется только между клиентскими приложениями и MAPI.
Освободите память для идентификатора записи, на который указывает параметр lppWrappedEntry , с помощью функции MAPIFreeBuffer по завершении использования идентификатора записи.