IRowsetUpdate Interface

IID_IRowsetUpdate

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

IRowsetUpdate enables consumers to delay the transmission of changes made with IRowsetChange to the data store. This interface also enables consumers to undo changes before transmission.

Documentation: IRowsetUpdate

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IRowsetChange Methods

Description

DeleteRows

Deletes rows.

SetData

Sets data in one or more columns in a row.

InsertRow

Creates and initializes a new row.

IRowsetUpdate Methods

Description

GetOriginalData

Gets the data most recently fetched from or transmitted to the data store; does not get values based on pending changes.

GetPendingRows

Returns a list of rows with pending changes.

GetRowStatus

Returns the status of rows.

Undo

Undoes any changes made to a row since it was last fetched or since Update was called for it.

Update

Transmits any changes made to a row since it was last fetched or since Update was called for it.

QueryInterface

FUNCTION IRowsetUpdate_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 IRowsetUpdate_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION IRowsetUpdate_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Release

FUNCTION IRowsetUpdate_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

DeleteRows

FUNCTION IRowsetUpdate_DeleteRows ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hChapter AS DWORD _

, BYVAL cRows AS DWORD _

, BYVAL rghRows AS DWORD _

, BYREF rgRowStatus AS DWORD _

  ) AS LONG

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

END FUNCTION

SetData

FUNCTION IRowsetUpdate_SetData ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hRow AS DWORD _

, BYVAL hAccessor AS DWORD _

, BYVAL pData AS DWORD _

  ) AS LONG

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

END FUNCTION

InsertRow

FUNCTION IRowsetUpdate_InsertRow ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hChapter AS DWORD _

, BYVAL hAccessor AS DWORD _

, BYVAL pData AS DWORD _

, BYREF phRow AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IRowsetUpdate_InsertRow (pthis, hChapter, hAccessor, pData, phRow) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetOriginalData

FUNCTION IRowsetUpdate_GetOriginalData ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hRow AS DWORD _

, BYVAL hAccessor AS DWORD _

, BYVAL pData AS DWORD _

  ) AS LONG

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

END FUNCTION

GetPendingRows

FUNCTION IRowsetUpdate_GetPendingRows ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hReserved AS DWORD _

, BYVAL dwRowStatus AS DWORD _

, BYREF pcPendingRows AS DWORD _

, BYREF prgPendingRows AS DWORD _

, BYREF prgPendingStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IRowsetUpdate_GetPendingRows (pthis, hReserved, dwRowStatus, pcPendingRows, prgPendingRows, prgPendingStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetRowStatus

FUNCTION IRowsetUpdate_GetRowStatus ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hReserved AS DWORD _

, BYVAL cRows AS DWORD _

, BYREF rghRows AS DWORD _

, BYREF rgPendingStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING IRowsetUpdate_GetRowStatus (pthis, hReserved, cRows, rghRows, rgPendingStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Undo

FUNCTION IRowsetUpdate_Undo ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hReserved AS DWORD _

, BYVAL cRows AS DWORD _

, BYREF rghRows AS DWORD _

, BYREF pcRowsUndone AS DWORD _

, BYREF prgRowsUndone AS DWORD _

, BYREF prgRowStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING IRowsetUpdate_Undo (pthis, hReserved, cRows, rghRows, pcRowsUndone, prgRowsUndone, prgRowStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Update

FUNCTION IRowsetUpdate_Update ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hReserved AS DWORD _

, BYVAL cRows AS DWORD _

, BYREF rghRows AS DWORD _

, BYREF pcRows AS DWORD _

, BYREF prgRows AS DWORD _

, BYREF prgRowStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[10] USING IRowsetUpdate_Update (pthis, hReserved, cRows, rghRows, pcRows, prgRows, prgRowStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION