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]表示对象的条目标识符的字符串。

分列存储 ID

[out]指向包含对象的邮件存储的条目标识符的返回大小(以字节为单位)的指针。 如果 szMsgID 参数指向一个非编译项标识符字符串,则 该毫秒存储 ID 参数将指向零。

ppStoreEID

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

atmMsgEID

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

ppMsgEID

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

返回值

无。

注解

如果 szMsgID 参数指定的标识符是复合标识符,它将从 ASCII 转换,并拆分为对象在其邮件存储中的条目标识符和存储区的条目标识符。 仅转换和复制未编译的条目标识符字符串。 要分隔的复合标识符字符串通常由 HrComposeMsgID 函数创建。

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