IViewRowset::OpenViewRowset

Creates a rowset from a view.

Syntax

HRESULT OpenViewRowset (
   IUnknown     *pUnkOuter,
   REFIID        riid,
   IUnknown    **ppRowset);

Parameters

  • pUnkOuter
    [in] A pointer to the controlling IUnknown interface if the new rowset is being created as part of an aggregate. It is a null pointer if the rowset is not part of an aggregate.

  • riid
    [in] The IID of the interface requested on the rowset.

  • ppRowset
    [out] A pointer to memory in which to return the interface pointer on the newly created rowset. If IViewRowset::OpenViewRowset fails, *ppRowset is set to a null pointer.

Return Code

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.

  • E_INVALIDARG
    ppRowset was a null pointer.

  • E_NOINTERFACE
    The rowset did not support the interface specified in riid.

  • E_OUTOFMEMORY
    The provider did not have enough memory to create the rowset.

  • DB_E_NOAGGREGATION
    pUnkOuter was not a null pointer, and the provider is an OLE DB 1.0 or 1.1 provider that does not support aggregation of the rowset object being created.

    pUnkOuter was not a null pointer, and riid was not IID_IUnknown.

Comments

None.