SQLSetDriverConnectInfo, fonction

Article
05/23/2023

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

Résumé
SQLSetDriverConnectInfo est utilisé pour définir la chaîne de connexion dans le jeton d’informations de connexion pour l’appel SQLDriverConnect d’une application.

Syntaxe

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

Arguments

TokenHandle
[Entrée] Handle de jeton.

InConnectionString
[Entrée] Chaîne de connexion complète (voir la syntaxe dans « Comments » dans SQLDriverConnect), chaîne de connexion partielle ou 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.

Retours

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

Identique à SQLDriverConnect lié à toute erreur 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

Partager via