CDatabaseRecordset::StartUpdateRS

The StartUpdateRS method partially updates a record in the database. C syntax is shown.

void StartUpdateRS(
  CObject &coo
);

Parameters

coo

Reference to the record object to update.

Return Values

This method does not return a value.

Remarks

StartUpdateRS is useful when you need to update a record but do not have all the values required to call the UpdateRS method.

For example, suppose your application needs to add a station record to a CStationRecordset object but does not yet have the station's name value, only its call letters. Your application can pass a CStation object to StartUpdateRS with only the call letters specified. When your application acquires the station's name, you can add the name to the record by calling the SetField method. The record partially updated by StartUpdateRS remains open for editing until your application calls the EndUpdateRS method; in other words, when your application is finished editing the record it should call EndUpdateRS.

Requirements

  Windows NT/2000: Unsupported.
  Windows 95/98: Requires Windows 98.
  Header: Declared in dbsets.h.
  Import Library: Use dbsets.lib or dbsetsst.lib.

See Also

CDatabaseRecordset::EndUpdateRS, CDatabaseRecordset::SetField, CDatabaseRecordset::UpdateRS