CDatabaseRecordset::Seek

The Seek method returns a value that indicates whether the specified record object was found in the recordset. C syntax is shown.

BOOLEAN Seek(
  LPCTSTR lpszComparison,
  CObject &coo
);

Parameters

lpszComparison

String that indicates the type of comparison operation to perform, for example "=" or "<".

coo

In the protected CDatabaseRecordset implementation of this method, this parameter is a reference to the record object to search for.

In the public CChannelTRecordset implementation of this method, this parameter is a LONG that specifies the channel identifier of the channel record to search for.

In the public CEpisodeTRecordset implementation of this method, this parameter is a LONG that specifies the episode identifier of the episode to search for.

Return Values

Returns TRUE if the object was found in the recordset, and FALSE otherwise.

Remarks

Note that the Seek method only uses fields in the currently open index in the comparison. For example, if you passed a CStation object to the CStationRecordset::Seek method, Seek searches for the first record with matching call letters and ignores other fields such as the station name.

The table-specific version of Seek is implemented by the CTableNameRecordset objects that inherit from CDatabaseRecordset. However, Seek is implemented as a protected function by all recordset objects except CChannelTRecordset and CEpisodeTRecordset.

For more information on the inheritance structure of the Guide data objects, see About 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.

See Also

CChannelTRecordset, CEpisodeTRecordset