IDatabase::SeekRowset method

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

Moves the current position within the rowset.

Syntax

HRESULT SeekRowset(
  [in]  HROWSET        hRowset,
  [in]  SEEKROWSETTYPE tySeek,
  [in]  LONG           cRows,
  [out] LPROWORDINAL   piRowNew
);

Parameters

hRowset [in]

Type: HROWSET

Specifies the Rowset that will be used.

tySeek [in]

Type: SEEKROWSETTYPE

Specifies how the current position will be moved.

cRows [in]

Type: LONG

Specifies how far to move the current position in the rowset. If SEEK_ROWSET_BEGIN or SEEK_ROWSET_END is specified, cRows will specify an offset from the beginning or the end of the rows in the set.

piRowNew [out]

Type: LPROWORDINAL

Optional. Will return the current position of the rowset. Counting starts at 1.

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_NORECORDS	Indicates there are no records in the Rowset.

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)