OLE DB Programmer's Reference

IRowPosition::GetRowset

Returns a pointer to the underlying rowset.

HRESULT GetRowset (
   REFIID        riid,
   IUnknown **   ppRowset);

Parameters

riid
[in]
The requested IID for the rowset returned in *ppRowset.
ppRowset
[out]
A pointer to memory in which to return the interface pointer of the underlying rowset.

Return Code

S_OK
The method succeeded.
E_INVALIDARG
ppRowset was a null pointer.
E_NOINTERFACE
riid referenced IID_NULL.

ppRowset did not support the interface specified in riid.

E_UNEXPECTED
There is no current rowset.

ITransaction::Commit or ITransaction::Abort was called, and the object is in a zombie state.

Comments

Before ppRowset is returned, the row position object calls IUnknown::AddRef on it.