SQLSetConnectAttr (カーソル ライブラリ)

重要

この機能は、Windows の将来のバージョンで削除される予定です。 新しい開発作業ではこの機能を使用しないでください。また、現在この機能を使用しているアプリケーションの変更を計画してください。 Microsoft では、ドライバーのカーソル機能を使用することをお勧めします。

このトピックでは、カーソル ライブラリでの SQLSetConnectAttr 関数の使用について説明します。 SQLSetConnectAttr の一般的な情報については、「SQLSetConnectAttr 関数」を参照してください。

アプリケーションは、SQL_ATTR_ODBC_CURSORS属性を使用して SQLSetConnectAttr を呼び出して、カーソル ライブラリを常に使用するか、ドライバーがスクロール可能なカーソルをサポートしていない場合に使用するか、一度も使用しないかを指定します。 カーソル ライブラリは、 ドライバーが SQLGetInfo のSQL_STATIC_CURSOR_ATTRIBUTES1情報の種類のSQL_CA1_RELATIVEを返す場合、スクロール可能なカーソルをサポートすることを前提としています。

アプリケーションは、SQLSetConnectAttr を呼び出して、接続を割り当てるSQL_HANDLE_DBCの HandleType を指定して SQLAllocHandle を呼び出した後、データ ソースに接続する前にカーソル ライブラリの使用法を指定する必要があります。 接続がまだアクティブな状態で、アプリケーションが SQL_ATTR_ODBC_CURSORS 属性を使用して SQLSetConnectAttr を呼び出した場合、カーソル ライブラリはエラーを返します。

接続に関連付けられているすべてのステートメントに対してカーソル ライブラリでサポートされるステートメント属性を設定するには、データ ソースに接続した後、カーソルを開く前に、そのステートメント属性に対して SQLSetConnectAttr を呼び出す必要があります。 アプリケーションがステートメント属性を使用して SQLSetConnectAttr を呼び出し、接続に関連付けられているステートメントでカーソルが開いている場合、カーソルが閉じて再度開くまで、ステートメント属性はそのステートメントに適用されません。