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