SQLGetStmtAttr

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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 el número 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 devuelve SQL_NC_ON, el valor de 0 en SQLRowCount solamente indica que SQL Server no ha devuelto un recuento de filas. Si devuelve SQL_NC_OFF, significa que NOCOUNT está desactivado y el valor de 0 en 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 se debe probar 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
ODBC API Implementation Details