SQLDriverConnect

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Le pilote ODBC SQL Server Native Client définit les attributs de connexion qui remplacent ou améliorent les mot clé de chaîne de connexion. Plusieurs mot clé de chaîne de connexion ont des valeurs par défaut spécifiées par le pilote ODBC SQL Server Native Client.

Pour obtenir la liste des mot clé disponibles dans le pilote ODBC SQL Server Native Client, consultez Utilisation de mots clés de chaîne d’Connecter ion avec SQL Server Native Client.

Pour plus d’informations sur les comportements par défaut des attributs de connexion SQL Server et du pilote, consultez SQLSet Connecter Attr.

Pour une discussion sur les chaîne de connexion mot clé valides pour SQL Server Native Client, consultez Utilisation de mots clés de chaîne d’Connecter ion avec SQL Server Native Client.

Lorsque la valeur du paramètre SQLDriver Connecter DriverCompletion est SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED, le pilote ODBC SQL Server Native Client récupère mot clé valeurs à partir de la boîte de dialogue affichée. Si la valeur mot clé est passée dans l’chaîne de connexion et que l’utilisateur ne modifie pas la valeur de l’mot clé dans la boîte de dialogue, le pilote ODBC SQL Server Native Client utilise la valeur du chaîne de connexion. Si la valeur n'est pas définie dans la chaîne de connexion et si l'utilisateur ne procède à aucune affectation dans la boîte de dialogue, le pilote utilise la valeur par défaut.

SQLDriver Connecter doit recevoir une valeur WindowHandle valide quand une valeur DriverCompletion nécessite (ou peut nécessiter) l’affichage de la boîte de dialogue de connexion du pilote. Un handle non valide retourne SQL_ERROR.

Spécifiez le mot clé DRIVER ou DSN. ODBC indique que, de ces deux mots clés, un pilote utilise celui qui est situé le plus à gauche et ignore l'autre si les deux sont spécifiés. Si DRIVER est spécifié ou est le plus à gauche des deux, et que la valeur du paramètre SQLDriver Connecter DriverCompletion est SQL_DRIVER_NOPROMPT, le mot clé SERVER et une valeur appropriée sont nécessaires.

Lorsque SQL_DRIVER_NOPROMPT est spécifié, les mots clés d'authentification utilisateur doivent être fournis avec des valeurs. Le pilote garantit que la chaîne « Trusted_Connection=yes » ou les mots clés UID et PWD à la fois sont disponibles.

Si la valeur du paramètre DriverCompletion est SQL_DRIVER_NOPROMPT ou SQL_DRIVER_COMPLETE_REQUIRED et que la langue ou la base de données provient du chaîne de connexion et n’est pas valide, SQLDriver Connecter retourne SQL_ERROR.

Si la valeur du paramètre DriverCompletion est SQL_DRIVER_NOPROMPT ou SQL_DRIVER_COMPLETE_REQUIRED et que la langue ou la base de données provient des définitions de source de données ODBC et n’est pas valide, SQLDriver Connecter utilise la langue ou la base de données par défaut pour l’ID utilisateur spécifié et retourne SQL_SUCCESS_WITH_INFO.

Si la valeur du paramètre DriverCompletion est SQL_DRIVER_COMPLETE ou SQL_DRIVER_PROMPT et si la langue ou la base de données n’est pas valide, SQLDriver Connecter réaffiche la boîte de dialogue.

SQLDriverConnect prend en charge les fonctionnalités de récupération d'urgence, haute disponibilité

Pour plus d’informations sur l’utilisation de SQLDriver Connecter pour vous connecter à un cluster de groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre.

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

SQLDDriver Connecter utilisera la boîte de dialogue Connexion ODBC lorsque l’invite est activée. Celle-ci vous permet d'entrer des SPN à la fois pour le serveur principal et pour le partenaire de basculement.

SQLDriver Connecter acceptera les nouveaux chaîne de connexion mot clé ServerSPN et FailoverPartnerSPN, et reconnaîtra les nouveaux attributs de connexion SQL_COPT_SS_SERVER_SPN et SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Lorsqu'une valeur d'attribut de connexion est définie plus d'une fois, toute valeur définie par programme à priorité sur la valeur d'un DSN et sur toute valeur dans une chaîne de connexion. Une valeur dans un DSN est prioritaire par rapport à une valeur dans une chaîne de connexion.

Lorsqu’une connexion est ouverte, SQL Server Native Client définit SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD à la méthode d’authentification utilisée pour ouvrir la connexion.

Pour plus d’informations sur les noms de principal de service, consultez Les noms de principal de service (SPN) dans les Connecter ions du client (ODBC).

Exemples

L’appel suivant illustre la quantité minimale de données requise pour SQLDriver Connecter :

SQLDriverConnect(hdbc, hwnd,  
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,  
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);

Les chaîne de connexion suivantes illustrent les données minimales requises lorsque la valeur du paramètre DriverCompletion est SQL_DRIVER_NOPROMPT :

"DSN=Human Resources;Trusted_Connection=yes"  
  
"FILEDSN=HR_FDSN;Trusted_Connection=yes"  
  
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"

Voir aussi

SQLDriverConnect, fonction
Détails de l’implémentation d’API ODBC
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)