IGetSourceRow::GetSourceRow

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

Syntax

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.