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

IRowsetWatchRegion

COM
IID0c733a45-2a1c-11ce-ade5-00aa0044773d継承元IRowsetWatchAll自前メソッド開始 vtbl6

メソッド 6

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

vtbl 6 HRESULT CreateWatchRegion(DWORD dwWatchMode, UINT_PTR* phRegion)
dwWatchModeDWORDin監視対象とする変更の種類を示す監視モードフラグを指定する。
phRegionUINT_PTR*out作成された監視領域のハンドルを受け取るポインタである。
vtbl 7 HRESULT ChangeWatchMode(UINT_PTR hRegion, DWORD dwWatchMode)
hRegionUINT_PTRin監視モードを変更する対象の監視領域のハンドルを指定する。
dwWatchModeDWORDin新たに設定する監視モードフラグを指定する。
vtbl 8 HRESULT DeleteWatchRegion(UINT_PTR hRegion)
hRegionUINT_PTRin削除する監視領域のハンドルを指定する。
vtbl 9 HRESULT GetWatchRegionInfo(UINT_PTR hRegion, DWORD* pdwWatchMode, UINT_PTR* phChapter, UINT_PTR* pcbBookmark, BYTE** ppBookmark, INT_PTR* pcRows)
hRegionUINT_PTRin情報を取得する対象の監視領域のハンドルを指定する。
pdwWatchModeDWORD*out監視領域に設定されている監視モードを受け取るポインタである。
phChapterUINT_PTR*out監視領域が属するチャプタのハンドルを受け取るポインタである。
pcbBookmarkUINT_PTR*inout返されるブックマークのバイト数を受け取るポインタである。
ppBookmarkBYTE**out監視領域の開始位置を示すブックマークを受け取るポインタである。
pcRowsINT_PTR*out監視領域に含まれる行数を受け取るポインタである。
vtbl 10 HRESULT Refresh(UINT_PTR* pcChangesObtained, DBROWWATCHCHANGE** prgChanges)
pcChangesObtainedUINT_PTR*inout取得された変更エントリの個数を受け取るポインタである。
prgChangesDBROWWATCHCHANGE**out発生した変更を記述する DBROWWATCHCHANGE 構造体配列を受け取るポインタである。
vtbl 11 HRESULT ShrinkWatchRegion(UINT_PTR hRegion, UINT_PTR hChapter, UINT_PTR cbBookmark, BYTE* pBookmark, INT_PTR cRows)
hRegionUINT_PTRin縮小する対象の監視領域のハンドルを指定する。
hChapterUINT_PTRin縮小後の領域が属するチャプタのハンドルを指定する。
cbBookmarkUINT_PTRinpBookmark が指すブックマークのバイト数を指定する。
pBookmarkBYTE*in縮小後の監視領域の新しい開始位置を示すブックマークへのポインタである。
cRowsINT_PTRin縮小後の監視領域に含める行数を指定する。

HSP用 COM定義

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

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