IMAPISession::CompareEntryIDs

适用于:Outlook 2013 | Outlook 2016

比较两个条目标识符,以确定它们是否引用同一对象。

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

指定为参数的一个或两个条目标识符不引用对象,可能是因为这些对象当前未打开且不可用。

备注

IMAPISession::CompareEntryIDs 方法比较属于单个服务提供程序的两个条目标识符,以确定它们是否引用同一对象。 MAPI 从条目标识符中提取 MAPIUID 部分,以确定负责对象的服务提供程序,然后调用其登录对象的 CompareEntryIDs 方法来执行比较。

给调用方的说明

CompareEntryIDs 方法很有用,因为对象可以有多个有效的条目标识符。 例如,安装新版本的服务提供商后,可能会出现这种情况。

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

MFCMAPI 引用

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

文件 函数 Comment
BaseDialog.cpp
CbaseDialog::OnCompareEntryIDs
MFCMAPI 使用 IMAPISession::CompareEntryIDs 方法比较用户输入的两个条目 ID。

另请参阅

MAPIUID

IMAPISession : IUnknown

MFCMAPI 代码示例