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

IInstallationAgent

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

メソッド 1

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

vtbl 7 HRESULT RecordInstallationResult(LPWSTR installationResultCookie, INT hresult, IStringCollection* extendedReportingData)
installationResultCookieLPWSTRin記録対象のインストール操作を識別するクッキー文字列を指定する。
hresultINTin記録するインストール結果を表す HRESULT 値を指定する。
extendedReportingDataIStringCollection*in結果と共に報告する拡張データの文字列コレクションを指定する IStringCollection へのポインタである。

HSP用 COM定義

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

#define global IID_IInstallationAgent "{925CBC18-A2EA-4648-BF1C-EC8BADCFE20A}"
#usecom global IInstallationAgent IID_IInstallationAgent "{317E92FC-1679-46FD-A0B5-F08914DD8623}"
#comfunc global IInstallationAgent_RecordInstallationResult  7 wstr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。