IDatabase::QueryRowset method

[QueryRowset is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Retrieves the values for a number of rows from the rowset.

Syntax

HRESULT QueryRowset(
  [in]      HROWSET hRowset,
  [in, out] LPVOID  prgpRecord,
  [out]     LPDWORD pcObtained
);

Parameters

hRowset [in]

Type: HROWSET

Specifies the Rowset that will be used.

prgpRecord [in, out]

Type: LPVOID

Specifies a caller-allocated buffer large enough to contain the desired number of records.

pcObtained [out]

Type: LPDWORD

Specifies the number of records that were returned.

Return value

Type: HRESULT

Returns one of the following codes. Use the SUCCEEDED macro to determine whether the operation succeeded.

Return code Description
S_OK
The operation succeeded.
S_FALSE
Indicates 0 records were retrieved.

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)