SQLSetDriverConnectInfo, fonction

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

Summary
SQLSetDriverConnectInfo sert à définir la chaîne de connexion dans le token info de connexion pour l'appel SQLDriverConnect d'une application.

Syntax

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );

Arguments

TokenHandle
[Entrée] Pseudo de jeton.

InConnectionString
[Entrée] Une chaîne de connexion complète (voir la syntaxe dans « Commentaires » dans SQLDriverConnect), une chaîne de connexion partielle, ou une chaîne vide.

StringLength1
[Entrée] Longueur de *InConnectionString, en caractères si la chaîne est Unicode, ou en octets si la chaîne est ANSI ou DBCS.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

C’est pareil pour SQLDriverConnect en ce qui concerne toute erreur de validation d’entrée, sauf que le gestionnaire de pilotes utilisera un HandleType de SQL_HANDLE_DBC_INFO_TOKEN et un Handle de hDbcInfoToken.

Remarks

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 de hDbcInfoToken et renvoie SQL_SUCCESS_WITH_INFO à l’application dans SQLConnect et SQLDriverConnect.

Les applications ne devraient pas appeler cette fonction directement. Un pilote ODBC qui prend en charge le pooling de connexions conscient du pilote doit implémenter cette fonction.

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

Contenu connexe

  • Last updated on