SQLGetConnectAttr
El controlador ODBC de SQL Server Native Client define los atributos de conexión específicos del controlador. Algunos de los atributos están disponibles para SQLGetConnectAttr, y la función se usa para notificar sus valores actuales. Los valores presentados para estos atributos no se garantizan hasta que se haya realizado una conexión o el atributo se haya establecido mediante SQLSetConnectAttr.
Para obtener más información acerca de atributos, vea SQLSetConnectAttr.
SQL_COPT_SS_CONNECTION_DEAD
El atributo SQL_COPT_SS_CONNECTION_DEAD notifica el estado de una conexión a un servidor. El controlador consulta el estado actual de la conexión en la red.
Nota
El atributo de conexión ODBC estándar SQL_ATTR_CONNECTION_DEAD devuelve el estado más reciente de la conexión. Éste podría no ser el estado de la conexión actual.
Valor |
Descripción |
|---|---|
SQL_CD_TRUE |
Se ha perdido la conexión al servidor. |
SQL_CD_FALSE |
La conexión está abierta y disponible para procesar una instrucción. |
SQL_COPT_SS_PERF_DATA
El atributo SQL_COPT_SS_PERF_DATA devuelve un puntero a una estructura SQLPERF que contiene las estadísticas de rendimiento del controlador actual. SQLGetConnectAttr devolverá NULL si el registro de rendimiento no está habilitado. El controlador no actualiza de manera dinámica las estadísticas en la estructura SQLPERF. Llama a SQLGetConnectAttr cada vez que se actualicen las estadísticas de rendimiento.
Valor |
Descripción |
|---|---|
NULL |
El registro de rendimiento no está habilitado. |
Cualquier otro valor |
Un puntero a una estructura SQLPERF. |
SQL_COPT_SS_PERF_QUERY
El atributo SQL_COPT_SS_PERF_QUERY devuelve TRUE si está habilitado el registro de consultas de larga ejecución. La solicitud devuelve FALSE si el registro de consultas no está activo.
SQL_COPT_SS_USER_DATA
El atributo SQL_COPT_SS_USER_DATA recupera el puntero de datos de usuario. Los datos de usuario se almacenan en la memoria propiedad del cliente y se registran por conexión. Si el puntero de datos de usuario no se ha establecido, SQL_UD_NOTSET, se devuelve un puntero NULL.
Valor |
Descripción |
|---|---|
SQL_UD_NOTSET |
No se establece ningún puntero de datos de usuario. |
Cualquier otro valor |
Un puntero a los datos de usuario. |
Compatibilidad de SQLGetConnectAttr con los Nombres principales de servicio (SPN)
SQLGetConnectAttr se puede usar para consultar el valor de los nuevos atributos de conexión SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED y SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption también se puede usar para consultar estos valores.)
SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD solo está disponible para las conexiones abiertas que usan la autenticación de Windows.
Si no se ha establecido SQL_COPT_SS_SERVER_SPN o SQL_COPT_SS_FAILOVER_PARTNER, se devuelve el valor predeterminado (una cadena vacía).
Para obtener más información acerca de SPN, vea Nombres de entidad de seguridad del servicio (SPN) en conexiones de cliente (ODBC).