IMSProvider::CompareStoreIDs
適用対象: Outlook 2013 | Outlook 2016
2 つのメッセージ ストア エントリ識別子を比較して、それらが同じストア オブジェクトを参照しているかどうかを判断します。
HRESULT CompareStoreIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
パラメーター
cbEntryID1
[in] lpEntryID1 パラメーターによって指されるエントリ識別子のサイズ (バイト単位 )。
lpEntryID1
[in]比較する最初のエントリ識別子へのポインター。
cbEntryID2
[in] lpEntryID2 パラメーターによって指されるエントリ識別子のサイズ (バイト単位 )。
lpEntryID2
[in]比較する 2 番目のエントリ識別子へのポインター。
ulFlags
[����]�\��Ă��܂��B0 �ɂ���K�v������܂��B
lpulResult
[out]比較の返された結果へのポインター。 2 つのエントリ識別子が同じオブジェクトを参照している場合は TRUE。それ以外の場合は FALSE。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
注釈
MAPI は、IMAPISession::OpenMsgStore メソッドの呼び出しを処理するときに、IMSProvider::CompareStoreIDs メソッドを呼び出します。 CompareStoreID は 、開いているメッセージ ストアに関連付けられているプロファイル セクション (存在する場合) を決定するために、この時点で呼び出されます。 CompareStoreIDs 呼び出しは、特定のストア プロバイダーに対して開いているメッセージ ストアがない場合に行うことができます。 さらに、MAPI では、IMAPISupport::OpenProfileSection メソッドへのストア プロバイダー呼び出しを処理するときに、CompareStoreID も呼び出されます。
CompareStoreID で比較されるエントリ識別子は、どちらも現在のストア プロバイダーのダイナミック リンク ライブラリ (DLL) 用であり、どちらもラップされていないストア エントリ識別子です。 ストアエントリ識別子の折り返しの詳細については、「 IMAPISupport::WrapStoreEntryID」を参照してください。
エントリ識別子の比較は、オブジェクトに複数の有効なエントリ識別子を含めることができるので便利です。 これは、たとえば、メッセージ ストア プロバイダーの新しいバージョンがインストールされた後に発生する可能性があります。
関連項目
IMAPISupport::OpenProfileSection