Determines whether or not a row is a member of a chapter.
HRESULT IsRowInChapter ( HCHAPTER hChapter, HROW hRow);
Parameters
hChapter
[in]
The chapter handle.
hRow
[in]
The row handle.
Return Code
S_FALSE
The method succeeded and the row handle is not a member of this chapter.
S_OK
The method succeeded and the row handle is a member of the chapter.
E_FAIL
A provider-specific error occurred.
E_UNEXPECTED
ITransaction::Commit or ITransaction::Abort was called and the object is in a zombie state.
DB_E_BADROWHANDLE
hRow is invalid.
DB_E_BADCHAPTER
hChapter is invalid.
The rowset was single-chaptered and the specified chapter was not the currently open chapter. The consumer must use the currently open chapter or release the currently open chapter before specifying a new chapter.
Comments
This method makes no logical change to the state of the object.
This method determines whether or not a row handle is a member of a chapter. This comparison could be used, for example, if the consumer receives a row handle through one of the methods in IRowsetNotify and needs to know if it is a member of a chapter that the consumer already holds.