IViewRowset::OpenViewRowset

Creates a rowset from a view.

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 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 rowset being created does not support aggregation.

pUnkOuter was non-null and riid was not IID_Unknown.

Comments

None.