SQLDriverConnect
Le pilote ODBC SQL Native Client définit les attributs de connexion qui remplacent ou améliorent les mots clés de chaîne de connexion. Plusieurs mots clés de chaîne de connexion ont des valeurs par défaut spécifiées par le pilote ODBC SQL Native Client.
Pour obtenir la liste des mots clés disponibles dans le pilote ODBC SQL Native Client, consultez Using Connection String Keywords with SQL Native Client.
Pour plus d'informations sur les attributs de connexion et les comportements de pilotes par défaut de SQL Server, consultez SQLSetConnectAttr.
Lorsque la valeur du paramètre SQLDriverConnectDriverCompletion est SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED, le pilote ODBC SQL Native Client extrait les valeurs des mots clés à partir de la boîte de dialogue affichée. Si la valeur du mot clé est passée dans la chaîne de connexion et que l'utilisateur ne modifie pas la valeur du mot clé dans la boîte de dialogue, le pilote ODBC SQL Native Client utilise la valeur de la chaîne de connexion. Si la valeur n'est pas définie dans la chaîne de connexion et que l'utilisateur n'effectue aucune affectation dans la boîte de dialogue, le pilote utilise la valeur par défaut.
Un WindowHandle valide doit être affecté à SQLDriverConnect lorsqu'une valeur DriverCompletion nécessite (ou pourrait 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 stipule que si ces deux mots clés sont spécifiés, un pilote utilise celui situé le plus à gauche et ignore l'autre. Si DRIVER est spécifié ou est le mot clé le plus à gauche et que la valeur du paramètre SQLDriverConnectDriverCompletion est SQL_DRIVER_NOPROMPT, le mot clé SERVER et une valeur appropriée sont requis.
Lorsque SQL_DRIVER_NOPROMPT est spécifié, les mots clés d'authentification utilisateur doivent être présents avec des valeurs. Le pilote garantit que la chaîne « Trusted_Connection=yes » ou les deux mots clés UID et PWD sont présents.
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 de la chaîne de connexion et l'un des deux est non valide, SQLDriverConnect retourne SQL_ERROR.
Si la valeur du paramètre DriverCompletion est SQL_DRIVER_NOPROMPT ou SQL_DRIVER_COMPLETE_REQUIRED et que le langage ou la base de données provient des définitions de source de données ODBC et ni l'un ni l'autre n'est non valide, SQLDriverConnect utilise la langue ou la base de données par défaut pour l'ID d'utilisateur spécifié et retourne SQL_SUCCESS_WITH_INFO.
Si la valeur du paramètre DriverCompletion est SQL_DRIVER_COMPLETE or SQL_DRIVER_PROMPT et que la langue ou la base de données est non valide, SQLDriverConnect réaffiche la boîte de dialogue.
Exemples
L'appel suivant illustre la quantité minimale de données requise pour SQLDriverConnect:
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
Les chaînes de connexion suivantes illustrent la quantité minimale de données requise lorsque la valeur du paramètre DriverCompletion est SQL_DRIVER_NOPROMPT :
"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"
"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"
Voir aussi
Concepts
ODBC API Implementation Details
Autres ressources
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
Fonction SQLDriverConnect