Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 que son 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. La devolución es un entero que especifica la ubicación del comando en el lote. El valor 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 ValuePtr es de tipo SQLLEN.
| Importancia | 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 grandes o procedimientos almacenados pueden contener varias instrucciones SET NOCOUNT, por lo que no se puede suponer que SQL_SOPT_SS_NOCOUNT_STATUS permanecen constantes. 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 para la solicitud de notificación de consulta.
Parámetros con valores de tabla y SQLGetStmtAttr
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).
Véase también
Función SQLSetStmtAttr
Detalles de implementación de la API de ODBC