IGetSourceRow::GetSourceRow

  • Article

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.