IChapteredRowset::ReleaseChapter

  • Article

Releases a chapter.

Syntax

HRESULT ReleaseChapter (
   HCHAPTER    hChapter,
   DBREFCOUNT *pcRefCount);

Parameters

  • hChapter
    [in] The chapter handle.

  • pcRefCount
    [out] A pointer to memory in which to return the reference count of the chapter handle. If pcRefCount is a null pointer, no reference count is returned.

Return Code

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.

  • E_INVALIDARG
    The rowset was not chaptered.

  • DB_E_BADCHAPTER
    hChapter was invalid.

  • DB_E_NOTREENTRANT
    The provider called a method from IRowsetNotify in the consumer that had not yet returned, and the provider does not support reentrancy in this method.

Comments

If the chapter's reference count is reduced to zero and retrieved again later, the next fetch position of the retrieved chapter is reset to the initial state.

This method can be called while the rowset is in a zombie state to allow the consumer to clean up after a transaction has been committed or aborted.

See Also

Reference

IRowset::GetNextRows

IRowsetLocate::GetRowsAt