IMAPISupport::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
一或兩個指定為參數的專案標識元不會參考有效的物件,可能是因為它們目前未開啟且無法使用。
註解
針對通訊簿和訊息存放區提供者支援對象實作 IMAPISupport::CompareEntryIDs 方法。 CompareEntryIDs 會比較屬於單一服務提供者的兩個專案標識碼,以判斷它們是否參考相同的物件。 MAPI 會從專案標識符擷取 MAPIUID 部分,以判斷負責對象的服務提供者。 MAPI 接著會呼叫其登入物件的 CompareEntryIDs 方法來執行比較。
呼叫者注意事項
CompareEntryIDs 很有用,因為物件可以有一個以上的有效專案標識符。 例如,安裝新版本的服務提供者之後,就可能發生這種情況。
如果 CompareEntryIDs 傳 回錯誤,請勿根據比較結果採取任何動作。 相反地,請採取最保守的方法。 例如,如果其中一個或兩個專案標識碼都包含無效的MAPIUID結構,CompareEntryIDs可能會失敗。