SQLPoolConnect-funktion

Överensstämmelse
Version introducerad: ODBC 3.8 Standardefterlevnad: ODBC

Summary
SQLPoolConnect används för att skapa en ny anslutning om ingen anslutning i poolen kan återanvändas.

Syntax

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

Arguments

hDbc
[Input] Anslutningshandtaget.

hDbcInfoToken
[Input] Tokenhandtaget för den nya applikationsanslutningsförfrågan.

wszOutConnectString
[Utdata] Pekare till en buffert för den färdiga reťazec pripojenia. Vid lyckad anslutning till måldatakällan innehåller denna buffert den kompletta reťazec pripojenia. Applikationer bör tilldela minst 1 024 tecken för denna buffert.

Om wszOutConnectString är NULL, kommer cchConnectStringLen ändå att returnera det totala antalet tecken (exklusive null-termineringstecknet för teckendata) som finns tillgängliga att returnera i bufferten som wszOutConnectString pekar på.

cchConnectStringBuffer
[Input] Längden på *wszOutConnectString-bufferten , i tecken.

cchConnectStringLen
[Utdata] Pekare till en buffert där man returnerar det totala antalet tecken (exklusive null-termineringstecknet) som finns tillgängligt för att returnera i *wszOutConnectString. Om antalet tecken som kan returneras är större än eller lika med cchConnectStringBuffer, avkortas den kompletta reťazec pripojenia i *wszOutConnectString till cchConnectStringBuffer minus längden på ett null-termineringstecken.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR eller SQL_INVALID_HANDLE.

Diagnostics

Liknande SQLDriverConnect för alla inmatningsvalideringsfel, förutom att Driver Manager använder en HandleType av SQL_HANDLE_DBC_INFO_TOKEN och ett Handle av hDbcInfoToken.

Remarks

Driver Manager garanterar att föräldrahandtaget för hDbc och hDbcInfoToken är samma.

Till skillnad från SQLDriverConnect finns det inget DriverCompleten-argument som uppmanar användare att ange anslutningsinformation. En prompt-dialog är inte tillåten i pooling-scenariot.

Applikationer bör inte anropa denna funktion direkt. En ODBC-drivrutin som stödjer drivrutinsmedveten anslutningspooling måste implementera denna funktion.

När en drivrutin returnerar SQL_ERROR eller SQL_INVALID_HANDLE returnerar Driver Manager felet till applikationen (i SQLConnect eller SQLDriverConnect).

När en drivrutin returnerar SQL_SUCCESS_WITH_INFO hämtar Driver Manager diagnosinformationen från hDbcInfoToken och returnerar SQL_SUCCESS_WITH_INFO till applikationen i SQLConnect och SQLDriverConnect.

När en applikation använder SQLConnect kommer wszOutConnectString att vara en NULL-buffert (de tre sista parametrarna sätts alla till NULL, 0, NULL). Annars måste drivrutinen returnera utgångs-reťazec pripojenia, som återlämnas till applikationens SQLDriverConnect Function-anrop.

Inkludera sqlspi.h för ODBC-drivrutinsutveckling.

Relaterat innehåll

  • Last updated on