IResultDataCompare::Compare メソッド (mmc.h)
IResultDataCompare::Compare メソッドは、結果ウィンドウに挿入した結果アイテムを並べ替えるために、プライマリ スナップインが Cookie を比較する方法を提供します。
IResultDataCompare::Compare メソッドをスコープアイテムに使用することはできません。 ただし、この機能は IResultDataCompareEx::Compare メソッドによって提供されます。
構文
HRESULT Compare(
[in] LPARAM lUserParam,
[in] MMC_COOKIE cookieA,
[in] MMC_COOKIE cookieB,
[in, out] int *pnResult
);
パラメーター
[in] lUserParam
IResultData::Sort に渡されるユーザー指定の情報を指定する 値。 MMC では、このパラメーターは解釈されません。
[in] cookieA
並べ替え操作の一部として比較される最初の結果アイテム オブジェクトの一意識別子。
[in] cookieB
並べ替え操作の一部として比較する 2 番目の結果項目オブジェクトの一意識別子。
[in, out] pnResult
in パラメーターとして、引数には並べ替えられた列が含まれます。 out パラメーターとして、引数の値は次のようになります。
- 項目 1 項目 2 の場合は -1 <
- 項目 1 == 項目 2 の場合はゼロ (0)
- 項目 1 項目 2 の場合は 1 >
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
解説
Compare には、結果ウィンドウに表示される結果アイテム オブジェクトの並べ替え順序を決定するためのメカニズムが用意されています。 MMC によって提供される組み込みの並べ替えでは、C ランタイム ライブラリの文字列比較関数のみを使用してデータを比較します。 このインターフェイスが実装されている場合は、すべての比較に使用されます。
比較は、昇順の並べ替え順序に基づく必要があります。 ユーザーが標準の結果ビュー ヘッダーを切り替えた場合、コンソールは比較結果を補完するため、降順の並べ替え順序になります。
この IResultDataCompare インターフェイスは、仮想リストの並べ替えでは呼び出されません。 スナップインは仮想リストのすべてのアイテム データ ストレージを保持するため、スナップインはアイテム自体を並べ替える必要があります。 スナップインでは、仮想リストの並べ替えを提供するために IResultOwnerData インターフェイスを実装する必要があります。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |