ホーム › System.Com.StructuredStorage › IPropertyBag2

IPropertyBag2

COM

IID22f55882-280b-11d0-a8a9-00a0c90c2004継承元IUnknown自前メソッド開始 vtbl3

メソッド 5

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

vtbl 3 HRESULT Read(DWORD cProperties, PROPBAG2* pPropBag, IErrorLog* pErrLog, VARIANT* pvarValue, HRESULT* phrError)

cProperties	DWORD	in	読み取るプロパティの個数を指定する。
pPropBag	PROPBAG2*	in	読み取るプロパティを記述する PROPBAG2 構造体の配列へのポインタである。
pErrLog	IErrorLog*	in	読み取り中に発生したエラーを記録する IErrorLog へのポインタである。不要な場合は NULL を指定できる。
pvarValue	VARIANT*	out	読み取ったプロパティ値を格納する VARIANT 配列へのポインタである。
phrError	HRESULT*	inout	各プロパティの読み取り結果を示す HRESULT の配列へのポインタである。

vtbl 4 HRESULT Write(DWORD cProperties, PROPBAG2* pPropBag, VARIANT* pvarValue)

cProperties	DWORD	in	書き込むプロパティの個数を指定する。
pPropBag	PROPBAG2*	in	書き込むプロパティを記述する PROPBAG2 構造体の配列へのポインタである。
pvarValue	VARIANT*	in	書き込むプロパティ値を格納した VARIANT 配列へのポインタである。

vtbl 5 HRESULT CountProperties(DWORD* pcProperties)

pcProperties

DWORD*

out

プロパティバッグ内のプロパティの総数を受け取る。

vtbl 6 HRESULT GetPropertyInfo(DWORD iProperty, DWORD cProperties, PROPBAG2* pPropBag, DWORD* pcProperties)

iProperty	DWORD	in	情報を取得し始めるプロパティの 0 から始まるインデックスを指定する。
cProperties	DWORD	in	情報を取得するプロパティの個数を指定する。
pPropBag	PROPBAG2*	out	各プロパティの情報を格納する PROPBAG2 構造体の配列へのポインタである。
pcProperties	DWORD*	out	実際に情報が取得されたプロパティの個数を受け取る。

vtbl 7 HRESULT LoadObject(LPWSTR pstrName, DWORD dwHint, IUnknown* pUnkObject, IErrorLog* pErrLog)

pstrName	LPWSTR	in	読み込むオブジェクトに対応するプロパティの名前を指定する。
dwHint	DWORD	in	プロパティの検索を高速化するためのヒント値(PROPBAG2 の dwHint)を指定する。
pUnkObject	IUnknown*	in	値を読み込む対象オブジェクトの IUnknown へのポインタである。
pErrLog	IErrorLog*	in	読み込み中に発生したエラーを記録する IErrorLog へのポインタである。不要な場合は NULL を指定できる。

HSP用 COM定義

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

出力引数:

#define global IID_IPropertyBag2 "{22F55882-280B-11D0-A8A9-00A0C90C2004}"
#usecom global IPropertyBag2 IID_IPropertyBag2 "{}"
#comfunc global IPropertyBag2_Read             3 int,var,sptr,var,var
#comfunc global IPropertyBag2_Write            4 int,var,var
#comfunc global IPropertyBag2_CountProperties  5 var
#comfunc global IPropertyBag2_GetPropertyInfo  6 int,int,var,var
#comfunc global IPropertyBag2_LoadObject       7 wstr,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IPropertyBag2 "{22F55882-280B-11D0-A8A9-00A0C90C2004}"
#usecom global IPropertyBag2 IID_IPropertyBag2 "{}"
#comfunc global IPropertyBag2_Read             3 int,sptr,sptr,sptr,sptr
#comfunc global IPropertyBag2_Write            4 int,sptr,sptr
#comfunc global IPropertyBag2_CountProperties  5 sptr
#comfunc global IPropertyBag2_GetPropertyInfo  6 int,int,sptr,sptr
#comfunc global IPropertyBag2_LoadObject       7 wstr,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。