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 参数指向非编译项标识符字符串, 则 pcbStoreEID 参数指向零。

ppStoreEID

[out]指向指向包含该对象的消息存储的返回条目标识符的指针。 如果 szMsgID 参数指向非编译项标识符,则 在 ppStoreEID 参数中返回 NULL。

pcbMsgEID

[out]指向对象存储区内的条目标识符的返回大小(以字节为单位)的指针。 如果 szMsgID 参数指向非编译项标识符字符串,则 pcbMsgEID 参数等于 cbEID 参数的值。

ppMsgEID

[out]指向指向对象存储区中返回的条目标识符字符串的指针。 如果 szMsgID 参数指向非编译项标识符, ppMsgEID 将 指向指向非编译项标识符的转换副本的指针。

返回值

无。

注解

如果 szMsgID 参数指定的标识符是复合的,则会从 ASCII 转换,并将其拆分为其消息存储和存储的条目标识符中的对象的条目标识符。 非编译项标识符字符串只是转换和复制。 要分隔的复合标识符字符串通常是 HrComposeMsgID 函数创建的。

调用 HrDecomposeMsgID 函数等效于调用 HrEntryIDFromSz 函数,然后调用 HrDecomposeEID 函 数。