SQLGetStmtAttr
SQL Native Client ODBC ドライバでは、SQLGetStmtAttr を拡張して、ドライバ固有のステートメント属性を公開します。ドライバ固有の属性はすべて SQLINTEGER 値です。
SQL_TEXTPTR_LOGGING
text 型またはimage 型のデータを格納する列に対する操作のログ記録を公開します。
| 値 | 説明 |
|---|---|
SQL_TL_OFF |
text 型、ntext 型、および image 型のデータに対して実行される操作のログ記録を無効にします。 |
SQL_TL_ON |
既定値。text 型、ntext 型、および image 型のデータに対して実行される操作のログ記録を有効にします。 |
SQL_SOPT_SS_CURRENT_COMMAND
コマンド バッチの現在のコマンドを公開します。バッチ内のコマンドの位置を表す整数を返します。
SQL_SOPT_SS_HIDDEN_COLUMNS
SQL Server SELECT FOR BROWSE ステートメントで非表示された列を結果セットに公開します。既定では、ドライバはこのような列を公開しません。
| 値 | 説明 |
|---|---|
SQL_HC_OFF |
既定値。FOR BROWSE 列が結果セットで非表示になります。 |
SQL_HC_ON |
FOR BROWSE 列を公開します。 |
SQL_SOPT_SS_NCOUNT_STATUS
NOCOUNT オプションの現在の設定を示します。NOCOUNT オプションは、SQLRowCount が呼び出されたときに、SQL Server がステートメントで処理された行数を報告するかどうかを制御します。
| 値 | 説明 |
|---|---|
SQL_NC_OFF |
NOCOUNT を OFF にします。SQLRowCount は処理された行数を返します。 |
SQL_NC_ON |
NOCOUNT を ON にします。SQLRowCount は処理された行数を返しません。戻り値は 0 です。 |
SQLRowCount から 0 が返される場合は、アプリケーションで SQL_SOPT_SS_NOCOUNT_STATUS をテストする必要があります。SQL_NC_ON が返される場合、SQLRowCount から返される値が 0 であると、SQL Server から行数が返されなかったことを示します。SQL_NC_OFF が返される場合、NOCOUNT が無効になっており、SQLRowCount から返される値が 0 であると、ステートメントで処理された行がなかったことを示します。
SQL_SOPT_SS_NOCOUNT_STATUS が SQL_NC_OFF のときは、アプリケーションでは、SQLRowCount の値を表示しないでください。大きなバッチやストアド プロシージャには、複数の SET NOCOUNT ステートメントが含まれていることがあるので、SQL_SOPT_SS_NOCOUNT_STATUS が一定であると想定することはできません。SQLRowCount から 0 が返されるたびに、このオプションをテストする必要があります。
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
クエリ通知要求のメッセージ テキストを返します。
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS
クエリ通知要求で使用するオプションを指定します。オプションは、次に示すように、name=value 構文を使用した文字列で指定します。ユーザーがサービスを作成して、キューから通知を読み取る必要があります。
クエリ通知オプションの構文を次に示します。
service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]
次に例を示します。
service=mySSBService;local database=mydb
SQL_SOPT_SS_QUERYNOTIFICATION_TIMEOUT
クエリ通知をアクティブのままにしておく秒数を指定します。既定値は 432,000 秒 (5 日) です。