MDAC 2.5 SDK - OLE DB Programmer's Reference
OLE DB Interfaces

IGetSourceRow::GetSourceRow

Returns an interface pointer on the row object associated with the stream object.

HRESULT GetSourceRow(
   REFIID        riid,
   IUnknown **   ppRow
);

Parameters

riid

[in]
The IID of the interface on which to return a pointer.

ppRow

[out]
A pointer to memory in which to return the interface pointer. If the provider does not have a row object as the context for the stream object, it sets *ppRow to a null pointer. If IGetSourceRow::GetSourceRow fails, the provider must attempt to set *ppRow to a null pointer.

Return Code

S_OK

The method succeeded.

DB_E_NOSOURCEOBJECT

The provider did not have a row object as the context for the stream object. Therefore, it set *ppRow to a null pointer.

E_FAIL

A provider-specific error occurred.

E_INVALIDARG

ppRow was a null pointer.

E_NOINTERFACE

The row object did not support the interface specified in riid.

E_UNEXPECTED

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

Comments

None.