SQLGetStmtAttr
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
El controlador ODBC de SQL Server Native Client extiende SQLGetStmtAttr para exponer atributos de instrucción específicos del controlador.
SQLSetStmtAttr enumera los atributos de instrucción de lectura y escritura. En este tema se enumeran los atributos de instrucción de solo lectura.
SQL_SOPT_SS_CURRENT_COMMAND
El atributo SQL_SOPT_SS_CURRENT_COMMAND expone el comando actual de un lote de comandos. El retorno es un entero que especifica la ubicación del comando en el lote. El valor de ValuePtr es de tipo SQLLEN.
SQL_SOPT_SS_NOCOUNT_STATUS
El atributo SQL_SOPT_SS_NOCOUNT_STATUS indica la configuración actual de la opción NOCOUNT, que controla si SQL Server notifica los números de filas afectadas por una instrucción cuando se llama a SQLRowCount . El valor de ValuePtr es de tipo SQLLEN.
| Valor | Descripción |
|---|---|
| SQL_NC_OFF | NOCOUNT es OFF. SQLRowCount devuelve el número de filas afectadas. |
| SQL_NC_ON | NOCOUNT es ON. SQLRowCount no devuelve el número de filas afectadas y el valor devuelto es 0. |
Si SQLRowCount devuelve 0, la aplicación debe probar SQL_SOPT_SS_NOCOUNT_STATUS. Si se devuelve SQL_NC_ON, el valor de 0 de SQLRowCount solo indica que SQL Server no ha devuelto un recuento de filas. Si se devuelve SQL_NC_OFF, significa que NOCOUNT está desactivado y el valor de 0 de SQLRowCount indica que la instrucción no afecta a ninguna fila.
Las aplicaciones no deben mostrar el valor de SQLRowCount cuando SQL_SOPT_SS_NOCOUNT_STATUS es SQL_NC_OFF. Los lotes o los procedimientos almacenados grandes pueden contener varias instrucciones SET NOCOUNT, así que no se puede asumir que SQL_SOPT_SS_NOCOUNT_STATUS permanezca constante. Esta opción debe probarse cada vez que SQLRowCount devuelve 0.
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
El atributo SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT devuelve el texto del mensaje de la solicitud de notificación de consulta.
SQLGetStmtAttr y los parámetros de valores de tabla
Se puede llamar a SQLGetStmtAttr para obtener el valor de SQL_SOPT_SS_PARAM_FOCUS en el descriptor de parámetros de aplicación (APD) al trabajar con parámetros con valores de tabla. Para obtener más información sobre SQL_SOPT_SS_PARAM_FOCUS, vea SQLSetStmtAttr.
Para obtener más información sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).
Consulte también
Función SQLSetStmtAttr
Detalles de implementación de la API de ODBC