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

IRowsetFind

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

メソッド 1

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

vtbl 3 HRESULT FindNextRow(UINT_PTR hChapter, HACCESSOR hAccessor, void* pFindValue, DWORD CompareOp, UINT_PTR cbBookmark, BYTE* pBookmark, INT_PTR lRowsOffset, INT_PTR cRows, UINT_PTR* pcRowsObtained, UINT_PTR** prghRows)
hChapterUINT_PTRin検索を行う対象のチャプターハンドルを指定する。チャプターをサポートしない場合は 0 を指定する。
hAccessorHACCESSORin検索値の構成を記述するアクセサーのハンドルを指定する。
pFindValuevoid*in検索対象の比較値を格納したバッファへのポインタである。
CompareOpDWORDin検索値と各行を比較する際に用いる比較演算子を指定する。
cbBookmarkUINT_PTRinpBookmark が指すブックマークのサイズ(バイト数)を指定する。
pBookmarkBYTE*in検索の起点となる行を指すブックマークを格納したバッファへのポインタである。
lRowsOffsetINT_PTRin起点位置から検索を開始するまでにスキップする行数(オフセット)を指定する。
cRowsINT_PTRin取得する行数を指定する。負の値は逆方向への検索を表す。
pcRowsObtainedUINT_PTR*inout実際に取得された行数を受け取る。
prghRowsUINT_PTR**out条件に一致した行のハンドル配列へのポインタを受け取る。配列はプロバイダーが割り当てる。

HSP用 COM定義

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

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