ホーム › System.Mmc › IResultDataCompare

IResultDataCompare

COM

📘 Microsoft Learn (日本語) · English

IIDe8315a52-7a1a-11d0-a2d2-00c04fd909dd継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

プライマリスナップインが、結果ペインにソート順で表示される結果項目を比較できるようにします。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Compare(LPARAM lUserParam, INT_PTR cookieA, INT_PTR cookieB, INT* pnResult)

プライマリスナップインが、結果ペインに挿入する結果項目をソートする目的で cookie を比較する手段を提供します。

lUserParam	LPARAM	in	IResultData::Sort に渡される、ユーザー指定の情報を示す値です。MMC はこのパラメーターを解釈しません。
cookieA	INT_PTR	in	ソート操作の一環として比較される 1 つ目の結果項目オブジェクトの一意な識別子です。
cookieB	INT_PTR	in	ソート操作の一環として比較される 2 つ目の結果項目オブジェクトの一意な識別子です。
pnResult	INT*	inout	in パラメーターとして、この引数にはソート対象の列が格納されます。out パラメーターとして、引数の値は次のようになります。項目 1 < 項目 2 の場合は -1 項目 1 == 項目 2 の場合はゼロ (0) 項目 1 > 項目 2 の場合は 1

戻り値

このメソッドは、次のいずれかの値を返します。

解説(Remarks)

Compare は、結果ペインに表示される結果項目オブジェクトのソート順を決定するためのメカニズムを提供します。MMC が提供する組み込みのソートは、C ランタイムライブラリの文字列比較関数のみを使用してデータを比較します。このインターフェイスが実装されている場合は、すべての比較にこのインターフェイスが使用されます。

比較は昇順ソートに基づいて行う必要があります。ユーザーが標準の結果ビューのヘッダーを切り替えると、コンソールは比較結果を反転させ、降順ソートになります。

この IResultDataCompare インターフェイスは、仮想リストのソートには呼び出されません。仮想リストのすべての項目データストレージはスナップインが管理するため、スナップイン自身が項目をソートする必要があります。スナップインは、仮想リストのソートを提供するために IResultOwnerData インターフェイスを実装する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IResultDataCompare "{E8315A52-7A1A-11D0-A2D2-00C04FD909DD}"
#usecom global IResultDataCompare IID_IResultDataCompare "{}"
#comfunc global IResultDataCompare_Compare  3 sptr,sptr,sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IResultDataCompare "{E8315A52-7A1A-11D0-A2D2-00C04FD909DD}"
#usecom global IResultDataCompare IID_IResultDataCompare "{}"
#comfunc global IResultDataCompare_Compare  3 sptr,sptr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。