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 方法來比較專案標識符。 |