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 返回错误,请不要根据比较结果执行任何操作。 相反,采取最保守的方法。 例如,如果一个或两个条目标识符包含无效的 MAPIUIDCompareEntryID 可能会失败。

MFCMAPI 引用

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

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

另请参阅

MAPIUID

IMAPISession : IUnknown

MFCMAPI 代码示例