Compartir a través de


SQLGetStmtAttr

El controlador ODBC de SQL Server Native Client extiende SQLGetStmtAttr para exponer los 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 valor devuelto 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 el valor actual de la opción NOCOUNT, que controla si SQL Server notifica los números de filas afectados 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 solamente indica que SQL Server no ha devuelto un recuento de filas. Si devuelve SQL_NC_OFF, significa que ese NOCOUNT está desactivado y el valor de 0 de SQLRowCount indica que la instrucción no afectó 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 devuelva 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 con valores de tabla

Se puede llamar a SQLGetStmtAttr para obtener el valor de SQL_SOPT_SS_PARAM_FOCUS en el descriptor de parámetro de la aplicación (APD) cuando se trabaja 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 acerca de los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).

Historial de cambios

Contenido actualizado

Se han quitado los atributos de instrucción de lectura y escritura y se ha agregado la información de tipo de ValuePtr.