Functie SQLGetPoolID

Conformiteit
Versie geïntroduceerd: ODBC 3.81 Standaardnaleving: ODBC

Samenvatting
SQLGetPoolID haalt de pool-ID op.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Invoer] Tokenhandle die alle verbindingsinformatie bevat.

pPoolID
[Output] De pool-ID, die wordt gebruikt om een set verbindingen te identificeren die door elkaar gebruikt kunnen worden (mogelijk met een extra reset nodig).

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR of SQL_INVALID_HANDLE.

Diagnostiek

Wanneer SQLGetPoolID SQL_ERROR of SQL_SUCCESS_WITH_INFO teruggeeft, gebruikt de Driver Manager een HandleType van SQL_HANDLE_DBC_INFO_TOKEN en een Handle van hDbcInfoToken.

Remarks

SQLGetPoolID wordt gebruikt om de pool-ID te verkrijgen op basis van een set verbindingsinformatie (van SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo en SQLSetConnectInfo). Deze pool-ID wordt gebruikt om een set verbindingen te identificeren die door elkaar gebruikt kunnen worden (mogelijk met een extra reset nodig). De pool-ID wordt gebruikt om de verbindingspool voor die groep verbindingen te identificeren.

Telkens wanneer een driver SQL_ERROR of SQL_INVALID_HANDLE teruggeeft, geeft de Driver Manager de foutmelding terug naar de applicatie (in SQLConnect of SQLDriverConnect).

Telkens wanneer een driver SQL_SUCCESS_WITH_INFO terugstuurt, haalt de Driver Manager de diagnostische informatie op van hDbcInfoToken en stuurt SQL_SUCCESS_WITH_INFO terug naar de applicatie in SQLConnect en SQLDriverConnect.

Applicaties mogen deze functie niet direct aanroepen. Een ODBC-driver die driver-bewuste verbindingspooling ondersteunt, moet deze functie implementeren.

Voeg sqlspi.h toe voor ODBC-driverontwikkeling.

Verwante onderwerpen

  • Last updated on