HrComposeMsgID

Область применения: Outlook 2013 | Outlook 2016

Создает строку ASCII, представляющую составной идентификатор записи для объекта, обычно сообщения в хранилище сообщений.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения

HrComposeMsgID(
  LPMAPISESSION psession,
  ULONG cbStoreRecordKey,
  LPBYTE pStoreRecordKey,
  ULONG cbMsgEID,
  LPENTRYID pMsgEID,
  LPSTR FAR * pszMsgID
);

Параметры

Psession

[в] Указатель на сеанс, используемый клиентским приложением.

cbStoreRecordKey

[в] Размер (в байтах) ключа записи хранилища сообщений, содержащего сообщение или другой объект. Если в параметре cbStoreRecordKey передается ноль, параметр pszMsgID указывает на копию идентификатора записи, преобразованного в текст.

pStoreRecordKey

[в] Указатель на ключ записи хранилища сообщений, содержащего сообщение или другой объект.

cbMsgEID

[в] Размер (в байтах) идентификатора записи сообщения или другого объекта.

pMsgEID

[в] Указатель на идентификатор входа объекта.

pszMsgID

[out] Указатель на возвращенную строку ASCII. Если параметр cbStoreRecordKey больше нуля, параметр pszMsgID указывает на составной идентификатор записи, преобразованный в текст. Если значение cbStoreRecordKey равно нулю, pszMsgID указывает на идентификатор некомпундной записи, преобразованный в текст.

Возвращаемое значение

Нет.

Замечания

Если сообщение или другой объект, для которого создается составной идентификатор записи, находится в хранилище сообщений, строка идентификатора создается на основе идентификатора записи объекта и ключа записи хранилища. Если объект не находится в хранилище, то есть если число байтов для ключа записи хранилища, переданного в параметре cbStoreRecordKey , равно нулю, идентификатор записи объекта просто копируется и преобразуется в строку.

Вызов функции HrComposeMsgID эквивалентен вызову функции HrComposeEID , а затем функции HrSzFromEntryID .

HrComposeMsgID позволяет клиентским приложениям работать с объектами в нескольких хранилищах за счет использования составных идентификаторов записи. Приложение может вызвать функцию HrDecomposeMsgID , чтобы разделить составной идентификатор записи на его исходные компоненты.