IRowsetLocateImpl::Compare

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 IRowsetLocateImpl::Compare.

Compares two bookmarks.

Syntax

  
      STDMETHOD ( Compare )(  
   HCHAPTER /* hReserved */,  
   DBBKMARK cbBookmark1,  
   const BYTE* pBookmark1,  
   DBBKMARK cbBookmark2,  
   const BYTE* pBookmark2,  
   DBCOMPARE* pComparison   
);  

Parameters

See IRowsetLocate::Compare in the OLE DB Programmer's Reference.

Remarks

Either of the bookmarks can be a standard OLE DB-defined standard bookmark (DBBMK_FIRST, DBBMK_LAST, or DBBMK_INVALID). The value returned in pComparison indicates the relationship between the two bookmarks:

• DBCOMPARE_LT (cbBookmark1 is before cbBookmark2.)

• DBCOMPARE_EQ (cbBookmark1 is equal to cbBookmark2.)

• DBCOMPARE_GT (cbBookmark1 is after cbBookmark2.)

• DBCOMPARE_NE (The bookmarks are equal and not ordered.)

• DBCOMPARE_NOTCOMPARABLE (The bookmarks cannot be compared.)

Requirements

Header: atldb.h

See Also

IRowsetLocateImpl Class