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 define atributos de conexión específicos del controlador. Algunos de los atributos están disponibles para SQLGetConnectAttry la función se usa para informar de su configuración actual. Los valores notificados para estos atributos no se garantizan hasta después de que se haya realizado una conexión o el atributo se haya establecido mediante SQLSetConnectAttr.
En este tema se enumeran los atributos de solo lectura. Para obtener información sobre los otros atributos de conexión específicos del controlador ODBC de SQL Server Native Client, vea SQLSetConnectAttr.
SQL_COPT_SS_CONNECTION_DEAD
El atributo SQL_COPT_SS_CONNECTION_DEAD informa del estado de una conexión a un servidor. El controlador consulta la red para el estado actual de la conexión.
Nota:
El atributo de conexión ODBC estándar SQL_ATTR_CONNECTION_DEAD devuelve el estado más reciente de la conexión. Es posible que no sea el estado de conexión actual.
| Importancia | Descripción |
|---|---|
| SQL_CD_TRUE | Se ha perdido la conexión al servidor. |
| SQL_CD_FALSE | La conexión está abierta y disponible para el procesamiento de instrucciones. |
SQL_COPT_SS_CLIENT_CONNECTION_ID
El atributo SQL_COPT_SS_CLIENT_CONNECTION_ID recupera el identificador de conexión de cliente, que se puede usar para localizar:
Información de diagnóstico en el registro de XEvents, cuando está habilitada.
Información de error de conexión en el búfer del anillo de conexión.
Información de diagnóstico en los registros de seguimiento de acceso a datos, cuando está habilitada.
Para obtener más información, vea Obtener acceso a la información de diagnóstico en el registro de eventos extendidos.
| Importancia | Descripción |
|---|---|
| SQL_ERROR | Error en la conexión. |
| SQL_SUCCESS | La conexión se realizó correctamente. El identificador de conexión de cliente se encontrará en el búfer de salida. |
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 actuales.
SQLGetConnectAttr devolverá NULL si el registro de rendimiento no está habilitado. El controlador no actualiza dinámicamente las estadísticas de la estructura SQLPERF. Llame a SQLGetConnectAttr cada vez que es necesario actualizar las estadísticas de rendimiento.
| Importancia | Descripción |
|---|---|
| NULO | El registro de rendimiento no está habilitado. |
| Cualquier otro valor | Puntero a una estructura SQLPERF. |
SQL_COPT_SS_PERF_QUERY
El atributo SQL_COPT_SS_PERF_QUERY devuelve TRUE si se habilita el registro de consultas de larga duració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 no se ha establecido el puntero de datos de usuario, se devuelve SQL_UD_NOTSET, un puntero NULL.
| Importancia | Descripción |
|---|---|
| SQL_UD_NOTSET | No se ha establecido ningún puntero de datos de usuario. |
| Cualquier otro valor | Puntero a los datos del usuario. |
Compatibilidad de SQLGetConnectAttr con nombres de entidad de seguridad 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 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 sobre los SPN, consulte Nombres de entidad de seguridad de servicio (SPN) en Conexiones de cliente (ODBC).
Véase también
Función SQLGetConnectAttr
Detalles de implementación de la API de ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)