Share via


IViewChapter::OpenViewChapter

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

Syntax

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.