IViewRowset::OpenViewRowset

OLE DB Programmer's Reference

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 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.

1998-2001 Microsoft Corporation. All rights reserved.