CDatabaseRecordset::SeekAddRS

[This is preliminary documentation and subject to change.]

The SeekAddRS method checks the current recordset for a record object whose index field value is identical to that of the specified object. If it finds a match, it moves the recordset pointer to the matching object. If it does not find a match, it adds the record you passed in to the recordset.

For example, if you called the CStationRecordset::SeekAddRS method and passed in a CStation object, the method would compare the call letters in the object you passed in against the call letters of records in the recordset.

HRESULT SeekAddRS(
  CObject &coo  
);

Parameters

coo: A reference to a CTableName record object.

Return Values

Returns one of the following HRESULTS .

Value	Meaning
E_FAIL	The record does not exist and cannot be added.
S_FALSE	The record already exists, and SeekAddRS set the recordset pointer to the existing record.
S_OK	The record was added successfully.

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.