Partager via


SQLGetConnectAttr

Le pilote ODBC SQL Server Native Client définit des attributs de connexion spécifiques au pilote. Certains des attributs sont accessibles à SQLGetConnectAttr et la fonction est utilisée pour indiquer leurs paramètres actuels. Les valeurs indiquées pour ces attributs ne sont pas garanties tant qu'une connexion n'a pas été établie ou que l'attribut n'a pas été défini à l'aide de SQLSetConnectAttr.

Pour plus d'informations sur les attributs, consultez SQLGetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

L'attribut SQL_COPT_SS_CONNECTION_DEAD signale l'état d'une connexion à un serveur. Le pilote interroge le réseau afin de connaître l'état actuel de la connexion.

[!REMARQUE]

L'attribut de connexion ODBC standard SQL_ATTR_CONNECTION_DEAD retourne l'état le plus récent de la connexion. Cela peut ne pas être l'état actuel de la connexion.

Valeur

Description

SQL_CD_TRUE

La connexion au serveur a été perdue.

SQL_CD_FALSE

La connexion est ouverte et disponible pour le traitement d'instruction.

SQL_COPT_SS_PERF_DATA

L'attribut SQL_COPT_SS_PERF_DATA retourne un pointeur vers une structure SQLPERF contenant les statistiques actuelles de performances de pilote. SQLGetConnectAttr retourne NULL si l'enregistrement de performance n'est pas activé. Les statistiques dans la structure SQLPERF ne sont pas mises à jour de manière dynamique par le pilote. Appelez SQLGetConnectAttr chaque fois que les statistiques de performances doivent être actualisées.

Valeur

Description

NULL

L'enregistrement des performances n'est pas activé.

Toute autre valeur

Pointeur vers une structure SQLPERF.

SQL_COPT_SS_PERF_QUERY

L'attribut SQL_COPT_SS_PERF_QUERY retourne TRUE si l'enregistrement des longues requêtes est activé. La demande retourne FALSE si l'enregistrement des requêtes n'est pas actif.

SQL_COPT_SS_USER_DATA

L'attribut SQL_COPT_SS_USER_DATA extrait le pointeur de données utilisateur. Les données utilisateur sont stockées dans la mémoire détenue par le client et enregistrées par connexion. Si le pointeur de données utilisateur n'a pas été défini, SQL_UD_NOTSET, un pointeur NULL, est retourné.

Valeur

Description

SQL_UD_NOTSET

Aucun pointeur de données utilisateur n'est défini.

Toute autre valeur

Pointeur vers les données utilisateur.

Prise en charge de SQLGetConnectAttr pour les noms principaux de service (SPN)

SQLGetConnectAttr peut être utilisé pour interroger la valeur des nouveaux attributs de connexion SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption peut également être utilisé pour interroger ces valeurs.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD est disponible uniquement pour les connexions ouvertes qui utilisent l'authentification Windows.

Si SQL_COPT_SS_SERVER_SPN ou SQL_COPT_SS_FAILOVER_PARTNER n'a pas été défini, la valeur par défaut (une chaîne vide) est retournée.

Pour plus d'informations sur les noms principaux de service (SPN), consultez Noms principaux de service (SPN) dans les connexions clientes (ODBC).