Functie SQLPoolConnect

Conformiteit
Versie geïntroduceerd: ODBC 3.8 Standaardnaleving: ODBC

Samenvatting
SQLPoolConnect wordt gebruikt om een nieuwe verbinding aan te maken als geen verbinding in de pool opnieuw gebruikt kan worden.

Syntax

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );

Arguments

hDbc
[Invoer] Het verbindingshandvat.

hDbcInfoToken
[Invoer] De tokenhandle voor het nieuwe applicatie-verbindingsverzoek.

wszOutConnectString
[Output] Wijs naar een buffer voor de voltooide verbindingsreeks. Bij succesvolle verbinding met de doel-databron bevat deze buffer de voltooide verbindingsreeks. Applicaties moeten minstens 1.024 tekens toewijzen voor deze buffer.

Als wszOutConnectString NULL is, zal cchConnectStringLen nog steeds het totale aantal tekens teruggeven (exclusief het null-beëindigingsteken voor tekengegevens) dat beschikbaar is om terug te geven in de buffer waarnaar wszOutConnectString wijst.

cchConnectStringBuffer
[Invoer] Lengte van de *wszOutConnectString-buffer , in tekens.

cchConnectStringLen
[Output] Een aanwijzer naar een buffer waarin het totale aantal tekens (exclusief het null-beëindigingsteken) dat beschikbaar is om terug te geven in *wszOutConnectString, kan teruggeven. Als het aantal tekens dat kan teruggeven groter is dan of gelijk aan cchConnectStringBuffer, wordt de voltooide verbindingsreeks in *wszOutConnectString afgekapt tot cchConnectStringBuffer minus de lengte van een null-beëindigingsteken.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, of, SQL_INVALID_HANDLE.

Diagnostiek

Vergelijkbaar met SQLDriverConnect voor elke invoervalidatiefout, behalve dat de Driver Manager een HandleType van SQL_HANDLE_DBC_INFO_TOKEN en een Handle van hDbcInfoToken gebruikt.

Remarks

De Driver Manager garandeert dat de ouder HENV-handle van hDbc en hDbcInfoToken hetzelfde zijn.

In tegenstelling tot SQLDriverConnect is er geen DriverCompletement-argument om gebruikers te vragen verbindingsinformatie in te voeren. Een promptdialoog is niet toegestaan in het poolingscenario.

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

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.

Wanneer een applicatie SQLConnec gebruikt, is wszOutConnectString een NULL-buffer (de laatste drie parameters worden allemaal ingesteld op NULL, 0, NULL). Anders moet de driver de output verbindingsreeks teruggeven, die vervolgens wordt teruggegeven aan de SQLDriverConnect Function-aanroep van de applicatie.

Voeg sqlspi.h toe voor ODBC-driverontwikkeling.

Verwante onderwerpen

  • Last updated on