IGetSourceRow::GetSourceRow

OLE DB Programmer's Reference

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.

1998-2001 Microsoft Corporation. All rights reserved.