IMsgStore::CompareEntryIDs
適用対象: Outlook 2013 | Outlook 2016
2 つのエントリ識別子を比較して、メッセージ ストア内の同じエントリを参照するかどうかを判断します。 MAPI は、比較する両方のエントリ識別子の一意識別子 (UID) がそのプロバイダーによって処理される場合にのみ、サービス プロバイダーにこの呼び出しを渡します。
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
パラメーターとして指定されたエントリ識別子の一方または両方はオブジェクトを参照しません。これは、対応するオブジェクトが開かれていないため、現時点では使用できないためです。
注釈
IMsgStore::CompareEntryIDs メソッドは、メッセージ ストアに属する 2 つのエントリ識別子を比較して、それらが同じオブジェクトを参照しているかどうかを判断します。
呼び出し側への注意
CompareEntryIDs は、オブジェクトに複数の有効なエントリ識別子を持つことができます (たとえば、メッセージ ストア プロバイダーの新しいバージョンがインストールされた後など)。
CompareEntryIDs がエラーを返す場合は、比較の結果に基づいてアクションを実行しないでください。 代わりに、可能な限り最も保守的なアプローチを取ってください。 たとえば、エントリ識別子の一方または両方に無効な MAPIUID が含まれている場合、CompareEntryID は失敗する可能性があります。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| BaseDialog.cpp |
CBaseDialog::OnCompareEntryIDs |
MFCMAPI では、 IMsgStore::CompareEntryIDs メソッドを使用してエントリ ID を比較します。 |