IDatabase::FindRecord method

Finds one record in the database based on the index and number of keys provided.

Syntax

HRESULT FindRecord(
  [in]      INDEXORDNIAL iIndex,
  [in]      DWORD        cColumns,
  [in, out] LPVOID       pRecord,
  [out]     LPROWORDINAL piRow
);

Parameters

iIndex [in]

Type: INDEXORDNIAL

Specifies the index used to search the record with

cColumns [in]

Type: DWORD

Number of columns(keys) of the index to search with. COLUMNS_ALL means search with all keys in the index. If cColumns is smaller than the number of keys in the index, it means a partial search with only the first cColumns keys is.

pRecord [in, out]

Type: LPVOID

The record to be searched for. On input, pRecord should contain information in the columns that will be used for the search. On success, pRecord is filled with all information available from the database for the matching record.

piRow [out]

Type: LPROWORDINAL

Returns the ordinal position of the record that was found.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
DB_S_FOUND	The record was found.
DB_S_NOTFOUND	The record was not found.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Product	Outlook Express 6.0
IDL	Directdb.idl
DLL	Directdb.dll (version 6.0 or later)