IMAPISupport::CompareEntryIDs
適用対象: Outlook 2013 | Outlook 2016
2 つのエントリ識別子を比較して、同じオブジェクトを参照しているかどうかを判断します。
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]比較する 2 番目のエントリ識別子へのポインター。
ulFlags
[����]�\��Ă��܂��B0 �ɂ���K�v������܂��B
lpulResult
[out]比較の結果へのポインター。 2 つのエントリ識別子が同じオブジェクトを参照している場合は TRUE。それ以外の場合は FALSE。
戻り値
S_OK
比較は成功しました。
MAPI_E_UNKNOWN_ENTRYID
パラメーターとして指定されたエントリ識別子の一方または両方が有効なオブジェクトを参照しません。これは、現在開かれていないため、使用できない可能性があります。
注釈
IMAPISupport::CompareEntryIDs メソッドは、アドレス帳とメッセージ ストア プロバイダーのサポート オブジェクトに実装されます。 CompareEntryIDs は、 1 つのサービス プロバイダーに属する 2 つのエントリ識別子を比較して、同じオブジェクトを参照しているかどうかを判断します。 MAPI は、エントリ識別子から MAPIUID 部分を抽出して、オブジェクトを担当するサービス プロバイダーを決定します。 MAPI は、ログオン オブジェクトの CompareEntryIDs メソッドを呼び出して比較を実行します。
呼び出し側への注意
CompareEntryID は 、オブジェクトに複数の有効なエントリ識別子を含めることができるので便利です。 この状況は、たとえば、サービス プロバイダーの新しいバージョンがインストールされた後に発生する可能性があります。
CompareEntryIDs がエラーを返す場合は、比較の結果に基づいてアクションを実行しないでください。 代わりに、可能な限り最も保守的なアプローチを取ってください。 たとえば、エントリ識別子の一方または両方に無効な MAPIUID 構造体が含まれている場合、CompareEntryID は失敗する可能性があります。