HrDecomposeEID

适用于:Outlook 2013 | Outlook 2016

将对象的复合条目标识符(通常是消息存储中的消息)与存储区中该对象的条目标识符和存储的条目标识符分开。

属性
标头文件:
Mapiutil.h
实现者:
MAPI
调用者:
客户端应用程序
HrDecomposeEID(
  LPMAPISESSION psession,
  ULONG cbEID,
  LPENTRYID pEID,
  ULONG FAR * pcbStoreEID,
  LPENTRYID FAR * ppStoreEID,
  ULONG FAR * pcbMsgEID,
  LPENTRYID FAR * ppMsgEID
);

参数

psession

[in]指向客户端应用程序正在使用的会话的指针。

cbEID

[in]要分隔的复合条目标识符的大小(以字节为单位)。

pEID

[in]指向要分隔的复合条目标识符的指针。

pcbStoreEID

[out]指向包含 对象的消息存储的入口标识符的返回大小(以字节为单位)的指针。 如果 pEID 参数指向非复合入口标识符,则 “pcStoreEID ”参数指向零的值。

ppStoreEID

[out]指向包含 对象的消息存储的返回条目标识符的指针的指针。 如果 pEID 参数指向非复合条目标识符,则 ppStoreEID 参数中返回 NULL。

2012 年 10 月 20 日

[out]指向对象的条目标识符的返回大小(以字节为单位)的指针。 如果 pEID 参数指向非复合条目标识符,则 msgEID 参数等于 cbEID 参数的值。

ppMsgEID

[out]指向指向对象的返回条目标识符的指针的指针。 如果 pEID 参数指向非复合项标识符, 则 ppMsgEID 指向指向非复合条目标识符副本的指针。

返回值

无。

说明

如果 pEID 参数指定的标识符是复合的,则会将其拆分为消息存储中的 对象的入口标识符和存储的入口标识符。 仅复制非复合条目标识符字符串。 要分隔的复合标识符通常是 由 HrComposeEID 函数创建的标识符。

给调用方的说明

成功完成此函数后,将释放保存 pEID 参数的内存。 调用实现负责释放输出参数的内存。