CRowset::Update

Transmits any pending changes made to the current row since the last fetch or Update call on it.

HRESULT Update( 
   DBCOUNTITEM* pcRows = NULL, 
   HROW* phRow = NULL, 
   DBROWSTATUS* pStatus = NULL  
) throw( );

Parameters

  • pcRows
    [out] A pointer to the location where Update returns the number of rows it attempted to update, if required.

  • phRow
    [out] A pointer to the location where Update returns the handle of the row it attempted to update. No handle is returned if phRow is null.

  • pStatus
    [out] A pointer to the location where Update returns the row status value. No status is returned if pStatus is null.

Return Value

A standard HRESULT.

Remarks

Transmits any pending changes made to the current row since that row was last fetched or updated (using Update or UpdateAll). You typically call SetData to set data values in columns in a row, and then call Update to transmit those changes.

This method requires the optional interface IRowsetUpdate, which might not be supported on all providers; if this is the case, the method returns E_NOINTERFACE. You must also set DBPROP_IRowsetUpdate to VARIANT_TRUE before calling Open on the table or command containing the rowset.

Requirements

Header: atldbcli.h

See Also

Reference

CRowset Class

IRowsetUpdate::Update

CRowset::UpdateAll

CRowset::SetData

Other Resources

CRowset Members