Share via


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

See Also

CRowset Class
IRowsetScroll::GetApproximatePosition