CRowset::Update

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CRowset::Update.

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

Syntax

  
      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

CRowset Class
IRowsetUpdate::Update
CRowset::UpdateAll
CRowset::SetData