Win32 API 日本語リファレンス
ホームDevices.FunctionDiscovery › IFunctionInstanceCollectionQuery

IFunctionInstanceCollectionQuery

COM
IID57cc6fd2-c09a-4289-bb72-25f04142058e継承元IUnknown自前メソッド開始 vtbl3

メソッド 3

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

vtbl 3 HRESULT AddQueryConstraint(LPWSTR pszConstraintName, LPWSTR pszConstraintValue)
pszConstraintNameLPWSTRin追加する制約の名前。
pszConstraintValueLPWSTRin制約に適用する値。
vtbl 4 HRESULT AddPropertyConstraint(PROPERTYKEY* Key, PROPVARIANT* pv, PropertyConstraint enumPropertyConstraint)
KeyPROPERTYKEY*in制約対象のプロパティを指定するPROPERTYKEY。
pvPROPVARIANT*in比較に使用する値を保持するPROPVARIANT。
enumPropertyConstraintPropertyConstraintin比較条件(等しい等)を示すPropertyConstraint列挙値。
vtbl 5 HRESULT Execute(IFunctionInstanceCollection** ppIFunctionInstanceCollection)
ppIFunctionInstanceCollectionIFunctionInstanceCollection**outクエリ実行結果のインスタンスコレクションを受け取るポインター。

HSP用 COM定義

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

出力引数:
#define global IID_IFunctionInstanceCollectionQuery "{57CC6FD2-C09A-4289-BB72-25F04142058E}"
#usecom global IFunctionInstanceCollectionQuery IID_IFunctionInstanceCollectionQuery "{}"
#comfunc global IFunctionInstanceCollectionQuery_AddQueryConstraint     3 wstr,wstr
#comfunc global IFunctionInstanceCollectionQuery_AddPropertyConstraint  4 var,var,int
#comfunc global IFunctionInstanceCollectionQuery_Execute                5 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。