Win32 API 日本語リファレンス
ホームSystem.UpdateAgent › ICategory

ICategory

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID81ddc1b8-9d35-47a6-b471-5b80f519223b継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 9

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Name(LPWSTR* retval)
retvalLPWSTR*outカテゴリの名前を受け取る文字列ポインタへのポインタである。
vtbl 8 HRESULT get_CategoryID(LPWSTR* retval)
retvalLPWSTR*outカテゴリの一意な識別子 (GUID 文字列) を受け取る文字列ポインタへのポインタである。
vtbl 9 HRESULT get_Children(ICategoryCollection** retval)
retvalICategoryCollection**out子カテゴリのコレクションを表す ICategoryCollection インターフェイスを受け取るポインタへのポインタである。
vtbl 10 HRESULT get_Description(LPWSTR* retval)
retvalLPWSTR*outカテゴリの説明文を受け取る文字列ポインタへのポインタである。
vtbl 11 HRESULT get_Image(IImageInformation** retval)
retvalIImageInformation**outカテゴリに関連付けられた画像情報を表す IImageInformation インターフェイスを受け取るポインタへのポインタである。画像がない場合は NULL が返る。
vtbl 12 HRESULT get_Order(INT* retval)
retvalINT*outカテゴリの表示順序を表す値を受け取る出力先へのポインタである。
vtbl 13 HRESULT get_Parent(ICategory** retval)
retvalICategory**out親カテゴリを表す ICategory インターフェイスを受け取るポインタへのポインタである。親がない場合は NULL が返る。
vtbl 14 HRESULT get_Type(LPWSTR* retval)
retvalLPWSTR*outカテゴリの種類を表す文字列を受け取る文字列ポインタへのポインタである。
vtbl 15 HRESULT get_Updates(IUpdateCollection** retval)
retvalIUpdateCollection**outこのカテゴリに属する更新のコレクションを表す IUpdateCollection インターフェイスを受け取るポインタへのポインタである。

HSP用 COM定義

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

出力引数:
#define global IID_ICategory "{81DDC1B8-9D35-47A6-B471-5B80F519223B}"
#usecom global ICategory IID_ICategory "{}"
#comfunc global ICategory_get_Name         7 var
#comfunc global ICategory_get_CategoryID   8 var
#comfunc global ICategory_get_Children     9 sptr
#comfunc global ICategory_get_Description  10 var
#comfunc global ICategory_get_Image        11 sptr
#comfunc global ICategory_get_Order        12 var
#comfunc global ICategory_get_Parent       13 sptr
#comfunc global ICategory_get_Type         14 var
#comfunc global ICategory_get_Updates      15 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。