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。 |