SQLSetConnectInfo, fonction

Conformité
Version introduite : Conformité aux normes ODBC 3.81 : ODBC

Résumé
SQLSetConnectInfo est utilisé pour définir la source de données, l’ID utilisateur et le mot de passe dans le jeton d’informations de connexion pour l’appel SQLConnect d’une application.

Syntaxe

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );  

Arguments

TokenHandle
[Entrée] Handle de jeton.

ServerName
[Entrée] Nom de la source de données. Les données peuvent se trouver sur le même ordinateur que le programme ou sur un autre ordinateur quelque part sur un réseau. Pour plus d’informations sur la façon dont une application choisit une source de données, consultez Choix d’une source de données ou d’un pilote.

NameLength1
[Entrée] Longueur de *ServerName en caractères.

UserName
[Entrée] Identificateur d’utilisateur.

NameLength2
[Entrée] Longueur de *UserName en caractères.

Authentification
[Entrée] Chaîne d’authentification (généralement le mot de passe).

NameLength3
[Entrée] Longueur de *Authentification en caractères.

Retours

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

Identique à SQLConnect pour les erreurs de validation d’entrée, sauf que le Gestionnaire de pilotes utilise un HandleType de SQL_HANDLE_DBC_INFO_TOKEN et un Handle de hDbcInfoToken.

Remarques

Chaque fois qu’un pilote retourne SQL_ERROR ou SQL_INVALID_HANDLE, le Gestionnaire de pilotes renvoie l’erreur à l’application (dans SQLConnect ou SQLDriverConnect).

Chaque fois qu’un pilote retourne SQL_SUCCESS_WITH_INFO, le Gestionnaire de pilotes obtient les informations de diagnostic à partir de hDbcInfoToken et retourne SQL_SUCCESS_WITH_INFO à l’application dans SQLConnect et SQLDriverConnect.

Les applications ne doivent pas appeler cette fonction directement. Un pilote ODBC qui prend en charge le regroupement de connexions prenant en charge les pilotes doit implémenter cette fonction.

Incluez sqlspi.h pour le développement de pilotes ODBC.

Voir aussi

Développement d’un pilote ODBC
Regroupement de connexions prenant en charge les pilotes
Développement de la reconnaissance des pools de connexions dans un pilote ODBC