CDatabaseRecordset::InsertRecord

The InsertRecord method adds a record to the specified recordset. C syntax is shown.

BOOL InsertRecord(
  void *cRecordsetObject  
);

Parameters

cRecordsetObject

Pointer to a recordset object.

Return Values

Returns TRUE if InsertRecord succeeded in adding a record, and FALSE otherwise.

Remarks

If the InsertRecord method is called on a recordset of the dynaset type, it adds the record at the end of the recordset. For a recordset of the snapshot type for which an index is specified, InsertRecord adds the record in its proper place in the sort order. If the recordset is a snapshot and no index is specified, InsertRecord adds new records to the end of the recordset.

For more information on dynaset and snapshot recordsets, see Using Guide Data Objects.

Requirements

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