IDatabase::CreateRowset method

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

Creates a Rowset. Rowsets allow you to iterate through the rows in a database.

Syntax

HRESULT CreateRowset(
  [in]  INDEXORDINAL iIndex,
  [in]  DWORD        dwReserved,
  [out] LPHROWSET    phRowset
);

Parameters

iIndex [in]

Type: INDEXORDINAL

Specifies the index used to order the rows being iterated over.

dwReserved [in]

Type: DWORD

A reserved field.

phRowset [out]

Type: LPHROWSET

Returns a handle that will be used to interact with rowset later.

Return value

Type: HRESULT

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

Return code Description
SUCCEEDED
The operation succeeded.
DB_E_TOOMANYOPENROWSETS
Too many Rowsets are currently open.

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)