CDatabaseRecordset::InsertRecord

[This is preliminary documentation and subject to change.]

The InsertRecord method adds a record to the specified recordset.

BOOL InsertRecord(
  void* cRecordsetObject  
);
 

Parameters

cRecordsetObject

A pointer to a recordset object.

Return Values

A BOOL indicating the success or failure of the method. If this value is TRUE, the method succeeded. If it is FALSE, an error occurred.

Remarks

If the InsertRecord method is called on a dynaset-type recordset, the record is added at the end of the recordset. For a table-type recordset, for which an index has been specified, the record is added in their proper place in the sort order. If the recordset is a table-type and no index is specified, new records are added to the end of the recordset.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in dbsets.h.
  Import Library: Use dbsets.lib or dbsetsSt.lib.
  Unicode: Yes.