SQLSetStmtAttr

カーソルでのドライバ固有のパフォーマンス オプションを使用するかどうかを指定します。このオプションが設定されているときは、SQLGetData を使用できません。既定の設定は SQL_CO_OFF です。このオプションは、SQL Server 7.0 以降のインスタンスに接続している場合にのみ有効です。ValuePtr 値は SQLLEN 型です。

これらのオプションを設定すると、サーバーは最後の行がフェッチされたことを検出した時点で、カーソルを自動的に閉じます。その場合も、アプリケーションでは SQLFreeStmt (SQL_CLOSE) または SQLCloseCursor を呼び出す必要はありますが、ドライバからサーバーへ、カーソルを閉じる通知を送信する必要はありません。

選択リストに text、ntext、または image 列が含まれている場合、高速順方向専用カーソルが動的カーソルに変換され、SQLGetData が有効になります。

ステートメントをすぐに準備するか、SQLExecute、SQLDescribeCol、または SQLDescribeParam が実行されるまで準備を遅延するかを指定します。SQL Server 7.0 以前のバージョンでは、このプロパティは無視されます (準備は遅延されません)。ValuePtr 値は SQLLEN 型です。

ステートメント レベルのデータ変換を決定します。この属性を設定すると、日付、時刻、通貨の値を文字列値に変換する際に、ドライバはクライアントのロケール設定を使用します。この場合の変換は、SQL Server ネイティブ データ型から文字列への変換のみです。

ValuePtr 値は SQLLEN 型です。

地域別の変換の設定は、通貨、数値、日付、および時刻のデータ型に適用されます。変換の設定は、通貨、数値、日付、または時刻の値を文字列に変換するときの出力変換にのみ適用されます。

注意
ステートメント オプション SQL_SOPT_SS_REGIONALIZE が有効な場合、ドライバは現在のユーザーのロケール レジストリ設定を使用します。SetThreadLocale を呼び出す場合など、アプリケーションでスレッドのロケールが設定されているときは、現在のスレッドのロケールは無視されます。

データ ソースの地域別の動作を変更すると、アプリケーション エラーが発生することがあります。日付文字列を解析し、ODBC の定義に従った形式の日付文字列を受け付けるアプリケーションは、地域別の動作の値を変更することによって、悪影響を受ける可能性があります。

text 型または image 型のデータを含む列に対する操作のログ記録の有効と無効を切り替えます。ValuePtr 値は SQLLEN 型です。

SQL Server の SELECT FOR BROWSE ステートメントで非表示にされた列を結果セットに公開します。既定では、ドライバではこのような列は公開されません。ValuePtr 値は SQLLEN 型です。

クエリ通知要求のメッセージ テキストを返します。

クエリ通知要求で使用するオプションを指定します。オプションは、次に示すように、name=value 構文を使用した文字列で指定します。サービスの作成と、キューからの通知の読み取りは、アプリケーションが行います。

クエリ通知オプションの構文を次に示します。

service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]

次に例を示します。

service=mySSBService;local database=mydb

クエリ通知をアクティブのままにしておく秒数を指定します。既定値は 432,000 秒 (5 日) です。ValuePtr 値は SQLLEN 型です。

SQL_SOPT_SS_PARAM_FOCUS 属性は、後続の SQLBindParameter、SQLGetDescField、SQLSetDescField、SQLGetDescRec、および SQLSetDescRec の各呼び出しのフォーカスを指定します。

SQL_SOPT_SS_PARAM_FOCUS の型は SQLULEN です。

既定値は 0 で、SQL ステートメントのパラメータ マーカーに対応するパラメータが、上記の呼び出しで指定されます。テーブル値パラメータのパラメータ番号に設定すると、そのテーブル値パラメータの列が上記の呼び出しで指定されます。テーブル値パラメータのパラメータ番号以外の値に設定すると、エラー IM020 ("パラメータのフォーカスがテーブル値パラメータを参照していません") が返されます。

SQL_SOPT_SS_NAME_SCOPE 属性は、後続のカタログ関数呼び出しの名前スコープを指定します。SQLColumns から返される結果セットは、SQL_SOPT_SS_NAME_SCOPE の設定によって異なります。

SQL_SOPT_SS_NAME_SCOPE の型は SQLULEN です。

テーブル値パラメータのカタログとスキーマを識別するために、SS_TYPE_CATALOG_NAME と SS_TYPE_SCHEMA_NAME をそれぞれ、CatalogName パラメータと SchemaName パラメータで使用します。テーブル値パラメータのメタデータの取得が完了すると、アプリケーションによって、SQL_SOPT_SS_NAME_SCOPE は既定値 SQL_SS_NAME_SCOPE_TABLE に設定し直す必要があります。

SQL_SOPT_SS_NAME_SCOPE が SQL_SS_NAME_SCOPE_TABLE に設定されると、リンク サーバーへのクエリは失敗します。サーバー コンポーネントが格納されているカタログを使用して SQLColumns または SQLPrimaryKeys を呼び出すと、失敗します。

SQL_SOPT_SS_NAME_SCOPE を無効な値に設定しようとすると、SQL_ERROR が返され、"属性の値が正しくありません" というメッセージを含む SQLSTATE HY024 の診断レコードが生成されます。

SQL_SOPT_SS_NAME_SCOPE が SQL_SS_NAME_SCOPE_TABLE 以外の値になっているときに、SQLTables、SQLColumns、または SQLPrimaryKeys 以外のカタログ関数が呼び出されると、SQL_ERROR が返され、"関数のシーケンス エラーです (SQL_SOPT_SS_NAME_SCOPE が SQL_SS_NAME_SCOPE_TABLE に設定されていません)" というメッセージを含む SQLSTATE HY010 の診断レコードが生成されます。