CRowset::GetApproximatePosition
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CRowset::GetApproximatePosition.
Returns the approximate position of a row corresponding to a bookmark.
Syntax
HRESULT GetApproximatePosition(
const CBookmarkBase* pBookmark,
DBCOUNTITEM* pPosition,
DBCOUNTITEM* pcRows
) throw( );
Parameters
pBookmark
[in] A pointer to a bookmark that identifies the row whose position is to be found. NULL if only the row count is required.
pPosition
[out] A pointer to the location where GetApproximatePosition returns the position of the row. NULL if the position is not required.
pcRows
[out] A pointer to the location where GetApproximatePosition returns the total number of rows. NULL if the row count is not required.
Return Value
A standard HRESULT.
Remarks
This method requires the optional interface IRowsetScroll, which might not be supported on all providers; if this is the case, the method returns E_NOINTERFACE. You must also set DBPROP_IRowsetScroll to VARIANT_TRUE before calling Open on the table or command containing the rowset.
For information about using bookmarks in consumers, see Using Bookmarks.
Requirements
Header: atldbcli.h