HrComposeEID
Область применения: Outlook 2013 | Outlook 2016
Создает составной идентификатор записи для объекта, обычно сообщения в хранилище сообщений.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapiutil.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения |
HrComposeEID(
LPMAPISESSION psession,
ULONG cbStoreRecordKey,
LPBYTE pStoreRecordKey,
ULONG cbMsgEID,
LPENTRYID pMsgEID,
ULONG FAR * pcbEID,
LPENTRYID FAR * ppEID
);
Параметры
Psession
[в] Указатель на сеанс, используемый клиентским приложением.
cbStoreRecordKey
[в] Размер (в байтах) ключа записи хранилища сообщений, включающего сообщение или другой объект. Если в параметре cbStoreRecordKey передается ноль, параметр ppEID указывает на копию идентификатора записи объекта.
pStoreRecordKey
[в] Указатель на ключ записи хранилища сообщений, содержащего сообщение или другой объект.
cbMsgEID
[в] Размер (в байтах) идентификатора записи сообщения или другого объекта.
pMsgEID
[в] Указатель на идентификатор входа объекта.
pcbEID
[out] Указатель на размер возвращаемого идентификатора (в байтах).
ppEID
[out] Указатель на указатель на возвращенный идентификатор записи. Если значение параметра cbStoreRecordKey больше нуля, параметр ppEID указывает на указатель на созданный составной идентификатор записи. Если значение cbStoreRecordKey равно нулю, ppEID указывает на указатель на копию идентификатора записи объекта.
Возвращаемое значение
Нет.
Замечания
Если сообщение или другой объект, для которого создается составной идентификатор записи, находится в хранилище сообщений, идентификатор создается на основе идентификатора записи объекта и ключа записи хранилища. Если объект не находится в хранилище, то есть если число байтов для ключа записи хранилища, переданного в cbStoreRecordKey , равно нулю, идентификатор записи объекта просто копируется.
Функция HrComposeEID позволяет приложениям работать с объектами в нескольких хранилищах за счет использования составных идентификаторов записи. Приложение может вызвать функцию HrDecomposeEID , чтобы разделить идентификатор составной записи на его исходные компоненты.