SQLGetStmtAttr
适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
SQL Server Native Client ODBC 驱动程序扩展 SQLGetStmtAttr 以公开特定于驱动程序的语句属性。
SQLSetStmtAttr 列出了读取和写入的语句属性。 本主题列出只读语句属性。
SQL_SOPT_SS_CURRENT_COMMAND
SQL_SOPT_SS_CURRENT_COMMAND 属性公开命令批处理中的当前命令。 返回一个整数,该整数指定该命令在批处理中的位置。 ValuePtr 值的类型为 SQLLEN。
SQL_SOPT_SS_NOCOUNT_STATUS
SQL_SOPT_SS_NOCOUNT_STATUS属性指示 NOCOUNT 选项的当前设置,该选项控制 SQL Server 在调用 SQLRowCount 时是否报告受语句影响的行数。 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
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT 属性返回查询通知请求的消息文本。
SQLGetStmtAttr 和表值参数
使用表值参数时,可以调用 SQLGetStmtAttr 以获取应用程序参数描述符(APD)中的SQL_SOPT_SS_PARAM_FOCUS值。 有关SQL_SOPT_SS_PARAM_FOCUS的详细信息,请参阅 SQLSetStmtAttr。
有关表值参数的详细信息,请参阅表值参数(ODBC)。