Win32 API 日本語リファレンス
ホーム › Graphics.Printing › IPrinterPropertyBag

IPrinterPropertyBag

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

メソッド 10

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

vtbl 7 HRESULT GetBool(LPWSTR bstrName, BOOL* pbValue)
bstrNameLPWSTRin取得対象のプロパティ名。NULL不可の文字列を指定する。
pbValueBOOL*out取得したBOOL値を受け取る出力ポインタ。TRUE/FALSEが返る。
vtbl 8 HRESULT SetBool(LPWSTR bstrName, BOOL bValue)
bstrNameLPWSTRin設定対象のプロパティ名。NULL不可の文字列を指定する。
bValueBOOLin格納するBOOL値。TRUEまたはFALSEを指定する。
vtbl 9 HRESULT GetInt32(LPWSTR bstrName, INT* pnValue)
bstrNameLPWSTRin取得対象のプロパティ名。NULL不可の文字列を指定する。
pnValueINT*out取得した32ビット整数値を受け取る出力ポインタ。
vtbl 10 HRESULT SetInt32(LPWSTR bstrName, INT nValue)
bstrNameLPWSTRin設定対象のプロパティ名。NULL不可の文字列を指定する。
nValueINTin格納する32ビット符号付き整数値を指定する。
vtbl 11 HRESULT GetString(LPWSTR bstrName, LPWSTR* pbstrValue)
bstrNameLPWSTRin取得対象のプロパティ名。NULL不可の文字列を指定する。
pbstrValueLPWSTR*out取得した文字列を受け取る出力ポインタ。呼び出し側で解放が必要。
vtbl 12 HRESULT SetString(LPWSTR bstrName, LPWSTR bstrValue)
bstrNameLPWSTRin設定対象のプロパティ名。NULL不可の文字列を指定する。
bstrValueLPWSTRin格納する文字列値を指定する。NULL不可。
vtbl 13 HRESULT GetBytes(LPWSTR bstrName, DWORD* pcbValue, BYTE** ppValue)
bstrNameLPWSTRin取得対象のプロパティ名。NULL不可の文字列を指定する。
pcbValueDWORD*out取得したバイト配列の長さ(バイト数)を受け取る出力ポインタ。
ppValueBYTE**out取得したバイト配列バッファを受け取る出力ポインタ。要解放。
vtbl 14 HRESULT SetBytes(LPWSTR bstrName, DWORD cbValue, BYTE* pValue)
bstrNameLPWSTRin設定対象のプロパティ名。NULL不可の文字列を指定する。
cbValueDWORDin格納するバイト配列の長さ(バイト数)を指定する。
pValueBYTE*in格納するバイト配列の先頭を指すポインタを指定する。
vtbl 15 HRESULT GetReadStream(LPWSTR bstrName, IStream** ppValue)
bstrNameLPWSTRin取得対象のプロパティ名。NULL不可の文字列を指定する。
ppValueIStream**out読み取り用IStreamを受け取る出力ポインタ。要Release。
vtbl 16 HRESULT GetWriteStream(LPWSTR bstrName, IStream** ppValue)
bstrNameLPWSTRin対象のプロパティ名。NULL不可の文字列を指定する。
ppValueIStream**out書き込み用IStreamを受け取る出力ポインタ。要Release。

HSP用 COM定義

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

出力引数: 
#define global IID_IPrinterPropertyBag "{FEA77364-DF95-4A23-A905-019B79A8E481}"
#usecom global IPrinterPropertyBag IID_IPrinterPropertyBag "{}"
#comfunc global IPrinterPropertyBag_GetBool         7 wstr,var
#comfunc global IPrinterPropertyBag_SetBool         8 wstr,int
#comfunc global IPrinterPropertyBag_GetInt32        9 wstr,var
#comfunc global IPrinterPropertyBag_SetInt32        10 wstr,int
#comfunc global IPrinterPropertyBag_GetString       11 wstr,var
#comfunc global IPrinterPropertyBag_SetString       12 wstr,wstr
#comfunc global IPrinterPropertyBag_GetBytes        13 wstr,var,var
#comfunc global IPrinterPropertyBag_SetBytes        14 wstr,int,var
#comfunc global IPrinterPropertyBag_GetReadStream   15 wstr,sptr
#comfunc global IPrinterPropertyBag_GetWriteStream  16 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。