Funkce SQLPoolConnect

Soulad
Představená verze: ODBC 3.8 Shoda standardů: ODBC

Summary
SQLPoolConnect se používá k vytvoření nového připojení, pokud nelze žádné spojení v poolu znovu použít.

Syntax

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

Arguments

hDbc
[Vstup] Kontaktní klika.

hDbcInfoToken
[Vstup] Token handle pro žádost o připojení nové aplikace.

wszOutConnectString
[Výstup] Ukazatel na buffer pro dokončený připojovací řetězec. Po úspěšném připojení ke zdroji cílových dat tento buffer obsahuje dokončený připojovací řetězec. Aplikace by měly pro tento buffer vyčlenit alespoň 1 024 znaků.

Pokud je wszOutConnectString NULL, cchConnectStringLen stále vrátí celkový počet znaků (bez znaku null-termination pro znaková data), které lze vrátit v bufferu ukazovaném wszOutConnectString.

cchConnectStringBuffer
[Vstup] Délka bufferu *wszOutConnectString v znacích.

cchConnectStringLen
[Výstup] Ukazatel na buffer, do kterého lze vrátit celkový počet znaků (bez znaku null-terminingu), který je k dispozici pro vrácení v *wszOutConnectString. Pokud je počet znaků dostupných k vrácení větší nebo roven cchConnectStringBuffer, dokončený připojovací řetězec v *wszOutConnectString se zkrátí na cchConnectStringBuffer minus délka znaku null-terminingu.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, nebo SQL_INVALID_HANDLE.

Diagnostika

Podobně jako SQLDriverConnect pro jakoukoli chybu validace vstupu, ale Driver Manager používá HandleType of SQL_HANDLE_DBC_INFO_TOKEN a HandlehDbcInfoToken.

Remarks

Driver Manager zaručuje, že rodičovské HENV rozhraní hDbc a hDbcInfoToken jsou stejné.

Na rozdíl od SQLDriverConnect zde neexistuje argument DriverCompletion (Dokončení ovladače ), který by uživatele vyzval k zadání informací o připojení. Dialogová výzva je v poolingovém scénáři zakázána.

Aplikace by tuto funkci neměly volat přímo. ODBC ovladač, který podporuje poolování připojení s vědomím ovladačů, musí tuto funkci implementovat.

Kdykoli ovladač vrátí SQL_ERROR nebo SQL_INVALID_HANDLE, správce ovladačů vrátí chybu aplikaci (v SQLConnect nebo SQLDriverConnect).

Kdykoli ovladač SQL_SUCCESS_WITH_INFO vrátí, správce ovladačů získá diagnostické informace z hDbcInfoToken a vrátí SQL_SUCCESS_WITH_INFO aplikaci v SQLConnect a SQLDriverConnect.

Když aplikace používá SQLConnect, wszOutConnectString bude NULL buffer (poslední tři parametry jsou nastaveny na NULL, 0, NULL). Jinak musí ovladač vrátit výstupní připojovací řetězec, který bude vrácen do volání funkce SQLDriverConnect aplikace.

Zahrňte sqlspi.h pro vývoj ovladačů ODBC.

Související obsah

  • Last updated on