Partage via


SQLGetPoolID, fonction

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

Résumé
SQLGetPoolID récupère l’ID de pool.

Syntaxe

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );  

Arguments

hDbcInfoToken
[Entrée] Handle de jeton qui contient toutes les informations de connexion.

pPoolID
[Sortie] ID de pool, qui est utilisé pour identifier un ensemble de connexions qui peuvent être utilisées de manière interchangeable (nécessitant éventuellement une réinitialisation supplémentaire).

Retours

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

Lorsque SQLGetPoolID retourne SQL_ERROR ou SQL_SUCCESS_WITH_INFO, le Gestionnaire de pilotes utilise un HandleType de SQL_HANDLE_DBC_INFO_TOKEN et un Handle de hDbcInfoToken.

Remarques

SQLGetPoolID est utilisé pour obtenir l’ID de pool en fonction d’un ensemble d’informations de connexion (à partir de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo et SQLSetConnectInfo). Cet ID de pool est utilisé pour identifier un ensemble de connexions qui peuvent être utilisées de manière interchangeable (nécessitant éventuellement une réinitialisation supplémentaire). L’ID de pool sera utilisé pour identifier le pool de connexions pour ce groupe de connexions.

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