SQLGetStmtAttr
SQL Server Native Client ODBC ドライバでは、SQLGetStmtAttr を拡張して、ドライバ固有のステートメント属性を公開します。
SQLSetStmtAttr は、読み取りと書き込みの両方のステートメント属性を一覧表示します。このトピックでは、読み取り専用のステートメント属性の一覧を示します。
SQL_SOPT_SS_CURRENT_COMMAND
コマンド バッチの現在のコマンドを公開します。バッチ内のコマンドの位置を表す整数を返します。ValuePtr 値は SQLLEN 型です。
SQL_SOPT_SS_NOCOUNT_STATUS
SQL_SOPT_SS_NOCOUNT_STATUS 属性は NOCOUNT オプションの現在の設定を示します。これは、SQLRowCount が呼び出されたときに、SQL Server がステートメントで処理された行数を報告するかどうかを制御します。ValuePtr 値は SQLLEN 型です。
値 |
説明 |
|---|---|
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
クエリ通知要求のメッセージ テキストを返します。
SQLGetStmtAttr とテーブル値パラメータ
テーブル値パラメータを使用する場合、SQLGetStmtAttr を呼び出すと、アプリケーション パラメータ記述子 (APD) の SQL_SOPT_SS_PARAM_FOCUS の値を取得できます。SQL_SOPT_SS_PARAM_FOCUS の詳細については、「SQLSetStmtAttr」を参照してください。
テーブル値パラメータの詳細については、「テーブル値パラメータ (ODBC)」を参照してください。
変更履歴
変更内容 |
|---|
読み取りと書き込みのステートメント属性が削除され、ValuePtr の型情報が追加されました。 |