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
[in]指向客户端应用程序正在使用的会话的指针。
szMsgID
[in]表示对象的条目标识符的字符串。
pcbStoreEID
[out]指向包含 对象的消息存储的条目标识符的返回大小(以字节为单位)的指针。 如果 szMsgID 参数指向非复合条目标识符字符串,则 idStoreEID 参数指向零。
ppStoreEID
[out]指向包含 对象的消息存储的返回条目标识符的指针的指针。 如果 szMsgID 参数指向非复合条目标识符,则 ppStoreEID 参数中返回 NULL。
2012 年 10 月 20 日
[out]指向对象的存储区中对象入口标识符的返回大小(以字节为单位)的指针。 如果 szMsgID 参数指向非复合入口标识符字符串,则 msgEID 参数等于 cbEID 参数的值。
ppMsgEID
[out]指向指向对象存储区中对象返回的条目标识符字符串的指针的指针。 如果 szMsgID 参数指向非复合条目标识符, 则 ppMsgEID 指向指向非复合项标识符的已转换副本的指针。
返回值
无。
说明
如果 szMsgID 参数指定的标识符是复合标识符,则会将其从 ASCII 转换并拆分为消息存储和存储区入口标识符中的对象的条目标识符。 仅转换和复制非复合条目标识符字符串。 要分隔的复合标识符字符串通常是由 HrComposeMsgID 函数创建的。
调用 HrDecomposeMsgID 函数等效于调用 HrEntryIDFromSz 函数,然后调用 HrDecomposeEID 函数。