Поделиться через


HrDecomposeMsgID

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

Разделяет представление ASCII составного идентификатора записи объекта (обычно сообщения в хранилище сообщений) на идентификатор записи этого объекта в хранилище и идентификатор записи хранилища.

Свойство Значение
Файл заголовка:
Mapiutil.h
Реализовано в:
MAPI
Вызывающая сторона:
Клиентские приложения
HrDecomposeMsgID(
  LPMAPISESSION psession,
  LPSTR szMsgID,
  ULONG FAR * pcbStoreEID,
  LPENTRYID FAR * ppStoreEID,
  ULONG FAR * pcbMsgEID,
  LPENTRYID FAR * ppMsgEID
);

Параметры

Psession

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

szMsgID

[в] Строка, представляющая идентификатор записи объекта.

pcbStoreEID

[out] Указатель на возвращаемый размер (в байтах) идентификатора записи хранилища сообщений, содержащего объект . Если параметр szMsgID указывает на строку идентификатора несовершенной записи, то параметр pcbStoreEID указывает на ноль.

ppStoreEID

[out] Указатель на указатель на возвращенный идентификатор записи хранилища сообщений, содержащего объект . Если параметр szMsgID указывает на некомпондный идентификатор записи, в параметре ppStoreEID возвращается значение NULL.

pcbMsgEID

[out] Указатель на возвращаемый размер (в байтах) идентификатора записи объекта в его хранилище. Если параметр szMsgID указывает на некомпондную строку идентификатора записи, то параметр pcbMsgEID равен значению параметра cbEID .

ppMsgEID

[out] Указатель на указатель на возвращенную строку идентификатора записи объекта в его хранилище. Если параметр szMsgID указывает на некомпондный идентификатор записи, ppMsgEID указывает на указатель на преобразованную копию идентификатора записи, несовершенного.

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

Нет.

Замечания

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

Вызов функции HrDecomposeMsgID эквивалентен вызову функции HrEntryIDFromSz , а затем функции HrDecomposeEID .