HrComposeMsgID

  • 项目

适用于：Outlook 2013 | Outlook 2016

创建一个 ASCII 字符串，表示对象的复合条目标识符，通常是消息存储中的消息。

属性 值
标头文件：
 Mapiutil.h
实现者：
 MAPI
调用者：
 客户端应用程序
 
HrComposeMsgID(
  LPMAPISESSION psession,
  ULONG cbStoreRecordKey,
  LPBYTE pStoreRecordKey,
  ULONG cbMsgEID,
  LPENTRYID pMsgEID,
  LPSTR FAR * pszMsgID
);

参数

psession

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

cbStoreRecordKey

[in]包含消息或其他对象的消息存储区记录键的大小（以字节为单位）。 如果在 cbStoreRecordKey 参数中传递零， 则 pszMsgID 参数指向转换为文本的条目标识符的副本。

pStoreRecordKey

[in]指向包含消息或其他对象的消息存储的记录键的指针。

cbMsgEID

[in]消息或其他对象的条目标识符的大小（以字节为单位）。

pMsgEID

[in]指向 对象的条目标识符的指针。

pszMsgID

[out]指向返回的 ASCII 字符串的指针。 如果 cbStoreRecordKey 参数大于零， 则 pszMsgID 参数指向转换为文本的复合条目标识符。 如果 cbStoreRecordKey 为零， 则 pszMsgID 指向转换为文本的非复合条目标识符。

返回值

无。

说明

如果要为其创建复合条目标识符的消息或其他对象位于消息存储区中，则标识符字符串将从对象的条目标识符和存储的记录键创建。 如果对象不在存储区中，即，如果 cbStoreRecordKey 参数中传递的存储记录键的字节计数为零，则只需复制该对象的条目标识符并将其转换为字符串。

调用 HrComposeMsgID 函数等效于调用 HrComposeEID 函数，然后调用 HrSzFromEntryID 函数。

HrComposeMsgID 允许客户端应用程序通过使用复合条目标识符来处理多个存储区中的对象。 应用程序可以调用 HrDecomposeMsgID 函数，将复合条目标识符拆分为其原始组成部分。