SQLGetStmtAttr

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 为 off,从 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)

请参阅

概念

ODBC API 实现细节

其他资源

SQLSetStmtAttr 函数