IRowset Interface

IID_IRowset

{0C733A7C-2A1C-11CE-ADE5-00AA0044773D}

IRowset is the base rowset interface. It provides methods for fetching rows sequentially, getting the data from those rows, and managing rows.

Documentation: IRowset

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IRowset Methods

Description

AddRefRows

Adds a reference count to an existing row handle.

GetData

Retrieves data from the rowset's copy of the row.

GetNextRows

Fetches rows sequentially, remembering the previous position.

ReleaseRows

Releases rows.

RestartPosition

Repositions the next fetch position to its initial position; that is, its position when the rowset was first created.

QueryInterface

FUNCTION IRowset_QueryInterface ( _

  BYVAL pthis AS DWORD PTR _

, BYREF riid AS GUID _

, BYREF ppvObj AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[0] USING IRowset_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION IRowset_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS LONG
  CALL DWORD @@pthis[1] USING IRowset_AddRef (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

Release

FUNCTION IRowset_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS DWORD
  CALL DWORD @@pthis[2] USING IRowset_Release (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

AddRefRows

FUNCTION IRowset_AddRefRows ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cRows AS DWORD _

, BYVAL rghRows AS DWORD _

, BYREF rgRefCounts AS DWORD _

, BYREF rgRowStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IRowset_AddRefRows (pthis, cRows, rghRows, rgRefCounts, rgRowStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetData

FUNCTION IRowset_GetData ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hRow AS DWORD _

, BYVAL hAccessor AS DWORD _

, BYREF pData AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IRowset_GetData (pthis, hRow, hAccessor, pData) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetNextRows

FUNCTION IRowset_GetNextRows ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hChapter AS DWORD _

, BYVAL lRowsOffset AS LONG _

, BYVAL cRows AS LONG _

, BYREF pcRowsObtained AS DWORD _

, BYREF prghRows AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IRowset_GetNextRows (pthis, hChapter, lRowsOffset, cRows, pcRowsObtained, prghRows) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ReleaseRows

FUNCTION IRowset_ReleaseRows ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cRows AS DWORD _

, BYVAL rghRows AS DWORD _

, BYVAL rgRowOptions AS DWORD _

, BYREF rgRefCounts AS DWORD _

, BYREF rgRowStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IRowset_ReleaseRows (pthis, cRows, rghRows, rgRowOptions, rgRefCounts, rgRowStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

RestartPosition

FUNCTION IRowset_RestartPosition ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hChapter AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IRowset_RestartPosition (pthis, hChapter) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION