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

IViewChapter::OpenViewChapter

Returns a chapter for the rows meeting the specified view conditions.

HRESULT OpenViewChapter (
   HCHAPTER     hSource,
   HCHAPTER *   phViewChapter);

Parameters

hSource

[in]
A chapter defining the set of rows on which to apply the view. To apply a view to the root rowset, the consumer must use DB_NULL_HCHAPTER.

phViewChapter

[out]
A chapter reflecting the specified view conditions, or NULL to indicate that the view conditions should be applied to hSource.

Return Code

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred.

DB_E_BADCHAPTER

hSource was invalid.

DB_E_CANTFILTER

The described filter could not be opened. The provider may have limitations on the columns used in a filter or a limitation on the complexity of the filter.

DB_E_CANTORDER

The described order could not be opened. The provider may have limitations on the columns used in an order or a limitation on the complexity of the order.

DB_E_BADCOMPAREOP

A specified comparison operator was invalid.

Comments

None.