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

IFunctionInstance

COM
📘 Microsoft Learn (日本語) · English
IID33591c10-0bed-4f02-b0ab-1530d5533ee9継承元IServiceProvider自前メソッド開始 vtbl4

メソッド 4

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

vtbl 4 HRESULT GetID(WORD** ppszCoMemIdentity)
ppszCoMemIdentityWORD**outインスタンスの一意な識別子文字列を受け取るポインター。CoTaskMemFreeで解放する。
vtbl 5 HRESULT GetProviderInstanceID(WORD** ppszCoMemProviderInstanceIdentity)
ppszCoMemProviderInstanceIdentityWORD**outプロバイダー内でのインスタンス識別子を受け取るポインター。CoTaskMemFreeで解放する。
vtbl 6 HRESULT OpenPropertyStore(STGM dwStgAccess, IPropertyStore** ppIPropertyStore)
dwStgAccessSTGMinプロパティストアを開くアクセスモードを示すSTGM値。
ppIPropertyStoreIPropertyStore**out開いたプロパティストアを受け取るIPropertyStoreポインター。
vtbl 7 HRESULT GetCategory(WORD** ppszCoMemCategory, WORD** ppszCoMemSubCategory)
ppszCoMemCategoryWORD**outインスタンスのカテゴリ名を受け取るポインター。CoTaskMemFreeで解放する。
ppszCoMemSubCategoryWORD**outインスタンスのサブカテゴリ名を受け取るポインター。CoTaskMemFreeで解放する。

HSP用 COM定義

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

出力引数: 
#define global IID_IFunctionInstance "{33591C10-0BED-4F02-B0AB-1530D5533EE9}"
#usecom global IFunctionInstance IID_IFunctionInstance "{}"
#comfunc global IFunctionInstance_GetID                  4 var
#comfunc global IFunctionInstance_GetProviderInstanceID  5 var
#comfunc global IFunctionInstance_OpenPropertyStore      6 int,sptr
#comfunc global IFunctionInstance_GetCategory            7 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。