IMsgStore::CompareEntryIDs

  • 项目

适用于：Outlook 2013 | Outlook 2016

比较两个条目标识符，以确定它们是否引用消息存储中的同一条目。 仅当要比较的两个条目标识符中唯一标识符 (UID 的唯一标识符) 由该提供程序处理时，MAPI 才会将此调用传递给服务提供程序。

HRESULT CompareEntryIDs(
  ULONG cbEntryID1,
  LPENTRYID lpEntryID1,
  ULONG cbEntryID2,
  LPENTRYID lpEntryID2,
  ULONG ulFlags,
  ULONG FAR * lpulResult
);

参数

cbEntryID1

[in] lpEntryID1 参数 指向的条目标识符中的字节计数 。

lpEntryID1

[in]指向要比较的第一个条目标识符的指针。

cbEntryID2

[in] lpEntryID2 参数 指向的条目标识符中的字节计数 。

lpEntryID2

[in]指向要比较的第二个条目标识符的指针。

ulFlags

[in]保留;必须为零。

lpulResult

[out]指向比较结果的指针。 如果两个条目标识符引用同一对象，则为 TRUE;否则为 FALSE。

返回值

S_OK

比较成功。

MAPI_E_UNKNOWN_ENTRYID

指定为参数的一个或两个条目标识符不引用对象，可能是因为相应的对象尚未打开且目前不可用。

备注

IMsgStore：：CompareEntryIDs 方法比较属于消息存储的两个条目标识符，以确定它们是否引用同一对象。

给调用方的说明

CompareEntryID 很有用，因为一个对象可以有多个有效的条目标识符 (例如，在) 安装了新版本的消息存储提供程序之后。

如果 CompareEntryID 返回 错误，请不要根据比较结果采取任何操作。 相反，请尽可能采取最保守的方法。 例如，如果一个或两个条目标识符包含无效的 MAPIUID，则 CompareEntryID 可能会失败。

MFCMAPI 引用

有关 MFCMAPI 示例代码，请参阅下表。

文件 函数 Comment
BaseDialog.cpp
 CBaseDialog：：OnCompareEntryIDs
 MFCMAPI 使用 IMsgStore：：CompareEntryIDs 方法比较条目 ID。

另请参阅

MAPIUID

IMsgStore : IMAPIProp

MFCMAPI 代码示例