MDAC 2.5 SDK - OLE DB Programmer's Reference
OLE DB Interfaces

IViewChapter::GetSpecification

Returns the rowset from which the view was created.

HRESULT GetSpecification (
   REFIID        riid,
   IUnknown **   ppRowset);

Parameters

riid

[in]
The IID of the interface on which to return a pointer.

ppRowset

[out]
A pointer to memory in which to return the interface pointer. If IViewChapter::GetSpecification fails, it must attempt to set *ppRowset to a null pointer.

Return Code

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred.

E_NOINTERFACE

The view did not support the interface specified in riid.

E_OUTOFMEMORY

The provider was unable to allocate sufficient memory in which to return the rowset information.

Comments

IViewChapter::GetSpecification adds a reference count to the rowset. The consumer must call Release to release the reference count when it is no longer needed.