IRow

COM

IID0c733ab4-2a1c-11ce-ade5-00aa0044773d継承元IUnknown自前メソッド開始 vtbl3

メソッド 3

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

vtbl 3 HRESULT GetColumns(UINT_PTR cColumns, DBCOLUMNACCESS* rgColumns)

cColumns	UINT_PTR	in	rgColumns 配列に含まれる列の個数を指定する。
rgColumns	DBCOLUMNACCESS*	inout	取得する列の指定と取得した値・状態を受け取る DBCOLUMNACCESS 構造体の配列である。

vtbl 4 HRESULT GetSourceRowset(GUID* riid, IUnknown** ppRowset, UINT_PTR* phRow)

riid	GUID*	in	返すロウセットのインターフェイスを識別する GUID(IID)へのポインタである。
ppRowset	IUnknown**	outoptional	この行の取得元ロウセットのインターフェイスポインタを受け取る出力ポインタである。
phRow	UINT_PTR*	outoptional	返されたロウセット内におけるこの行のハンドル(HROW)を受け取る出力ポインタである。

vtbl 5 HRESULT Open(IUnknown* pUnkOuter, DBID* pColumnID, GUID* rguidColumnType, DWORD dwBindFlags, GUID* riid, IUnknown** ppUnk)

pUnkOuter	IUnknown*	inoptional	アグリゲーションを行う場合の制御側 IUnknown へのポインタである。アグリゲートしない場合は NULL を指定する。
pColumnID	DBID*	in	開く対象の列を識別する DBID へのポインタである。
rguidColumnType	GUID*	in	開く列の種別(ロウ、ロウセット、ストリームなど)を示す GUID へのポインタである。
dwBindFlags	DWORD	in	オブジェクトを開く際の動作を制御するバインドフラグを指定する。
riid	GUID*	in	返すオブジェクトのインターフェイスを識別する GUID(IID)へのポインタである。
ppUnk	IUnknown**	outoptional	開かれたオブジェクトの riid で指定したインターフェイスポインタを受け取る出力ポインタである。

HSP用 COM定義

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

出力引数:

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