WrapStoreEntryID
Область применения: Outlook 2013 | Outlook 2016
Преобразует внутренний идентификатор записи хранилища сообщений в идентификатор записи, более пригодный для использования системой обмена сообщениями.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения и поставщики услуг |
WrapStoreEntryID(
ULONG ulFlags,
LPSTR szDLLName,
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG * lpcbWrappedEntry,
LPENTRYID * lppWrappedEntry
);
Параметры
ulFlags
[в] Битовая маска флагов. Можно задать следующий флаг:
MAPI_UNICODE
Строки имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.
szDLLName
[в] Имя DLL поставщика хранилища сообщений.
cbOrigEntry
[в] Размер исходного идентификатора записи для хранилища сообщений (в байтах).
lpOrigEntry
[в] Указатель на структуру ENTRYID , содержащую исходный идентификатор записи.
lpcbWrappedEntry
[out] Указатель на размер (в байтах) нового идентификатора записи.
lppWrappedEntry
[out] Указатель на указатель на структуру ENTRYID , содержащую новый идентификатор записи.
Возвращаемое значение
Нет.
Замечания
Объект хранилища сообщений сохраняет внутренний идентификатор записи, который имеет значение только для поставщиков служб coresident с этим хранилищем сообщений. Для других компонентов обмена сообщениями MAPI предоставляет упаковаемую версию внутреннего идентификатора записи, который делает его узнаваемым как принадлежащий хранилищу сообщений. Поставщикам служб Coresident всегда должен быть присвоен исходный идентификатор входа в хранилище несрезанных сообщений; Клиентским приложениям всегда должна быть предоставлена версия оболочки, которая будет использоваться в любом месте домена обмена сообщениями и в других доменах.
Поставщик услуг может обтекать идентификатор записи хранилища сообщений с помощью функции WrapStoreEntryID или метода IMAPISupport::WrapStoreEntryID , который вызывает функцию WrapStoreEntryID . Поставщик должен упаковать идентификатор записи при предоставлении свойства PR_ENTRYID (PidTagEntryId) хранилища сообщений или записи его в раздел профиля, а также при предоставлении свойства PR_STORE_ENTRYID (PidTagStoreEntryId). MAPI заключает в оболочку идентификатор записи хранилища сообщений при ответе на вызов IMAPISession::OpenMsgStore .
Когда клиентское приложение передает идентификатор записи в хранилище сообщений в MAPI, например в вызове IMAPISession::OpenEntry , MAPI распаковывает идентификатор записи, прежде чем использовать его для вызова метода поставщика, например IMSProvider::Logon или IMSProvider::CompareStoreIDs.