IMAPISession::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
パラメーターとして指定されたエントリ識別子の一方または両方はオブジェクトを参照しません。これは、これらのオブジェクトが現在開かれていないため、使用できない可能性があります。
注釈
IMAPISession::CompareEntryIDs メソッドは、1 つのサービス プロバイダーに属する 2 つのエントリ識別子を比較して、それらが同じオブジェクトを参照しているかどうかを判断します。 MAPI は、エントリ識別子から MAPIUID 部分を抽出して、オブジェクトを担当するサービス プロバイダーを特定し、ログオン オブジェクトの CompareEntryIDs メソッドを呼び出して比較を実行します。
呼び出し側への注意
CompareEntryIDs メソッドは、オブジェクトに複数の有効なエントリ識別子を含めることができるので便利です。 この状況は、たとえば、サービス プロバイダーの新しいバージョンがインストールされた後に発生する可能性があります。
CompareEntryIDs がエラーを返す場合は、比較の結果に基づいてアクションを実行しないでください。 代わりに、可能な限り最も保守的なアプローチを取ってください。 たとえば、エントリ識別子の一方または両方に無効な MAPIUID が含まれている場合、CompareEntryID は失敗する可能性があります。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| BaseDialog.cpp |
CbaseDialog::OnCompareEntryIDs |
MFCMAPI では 、IMAPISession::CompareEntryIDs メソッドを使用して、ユーザーが入力した 2 つのエントリ ID を比較します。 |