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 函数将复合条目标识符拆分为其原始构成。