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 .