ODBC での行のブックマーク
ブックマークは、データ行の識別に使われる値です。ブックマーク値の意味を解釈できるのは、ドライバまたはデータ ソースのみです。たとえば、ブックマークは、行番号のような単純な値の場合も、ディスク アドレスのような複雑な値の場合もあります。ODBC では、アプリケーションが特定の行のブックマークを要求し、これを保存し、カーソルに戻して行に返します。
アプリケーションは SQLFetchScroll を使用して行をフェッチするときに、開始行を選択する基準としてブックマークを使用できます。これは、現在のカーソルの位置に依存しないので、絶対アドレスの形式になります。ブックマークが設定された行にスクロールするには、FetchOrientation に SQL_FETCH_BOOKMARK を指定して SQLFetchScroll を呼び出します。この操作では、SQL_ATTR_FETCH_BOOKMARK_PTR オプション属性によって示されるブックマークを使用します。結果として、そのブックマークによって識別される行で始まる行セットが返されます。アプリケーションは、SQLFetchScroll を呼び出すときの FetchOffset 引数にこの操作のオフセットを指定できます。オフセットを指定すると、結果の行セットの最初の行は、ブックマークで識別される行番号に FetchOffset 引数の数を加算した結果によって決まります。SQL Server Native Client ODBC ドライバでは、静的カーソルとキーセット カーソルに対してのみブックマークがサポートされます。ブックマークが設定されている場合に動的カーソルが要求されると、代わりにキーセット カーソルが開かれます。
ブックマークを SQLBulkOperations 関数と共に使用して、ブックマークの行から始まる一連の行に対して操作を実行することができます。