共用方式為


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 方法會比較屬於訊息存放區的兩個專案標識符,以判斷它們是否參考相同的物件。

呼叫者注意事項

CompareEntryIDs 很有用,因為物件可以有多個有效的專案標識碼 (例如,在安裝新版本的訊息存放區提供者之後) 。

如果 CompareEntryIDs 傳 回錯誤,請勿根據比較結果採取任何動作。 相反地,請採取最保守的方法。 例如,如果其中一個或兩個專案識別碼都包含無效的MAPIUID,CompareEntryIDs 可能會失敗。

MFCMAPI 參考

如需 MFCMAPI 範例程式代碼,請參閱下表。

檔案 Function Comment
BaseDialog.cpp
CBaseDialog::OnCompareEntryIDs
MFCMAPI 使用 IMsgStore::CompareEntryIDs 方法來比較專案標識符。

另請參閱

MAPIUID

IMsgStore:IMAPIProp

MFCMAPI 作為程式碼範例