SQLPoolConnect, funkcja

Zgodność
Wprowadzona wersja: ODBC 3.8 Zgodność ze standardami: ODBC

Podsumowanie
SQLPoolConnect służy do utworzenia nowego połączenia, jeśli żadne połączenie w puli nie może być ponownie użyte.

Syntax

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

Arguments

hDbc
[Input] Uchwyt połączenia.

hDbcInfoToken
[Input] Uchwyt tokena dla nowego żądania połączenia aplikacji.

wszOutConnectString
[Wyjście] Wskaźnik do bufora dla ukończonego parametry połączenia. Po pomyślnym połączeniu ze źródłem docelowych danych, ten bufor zawiera ukończony parametry połączenia. Aplikacje powinny przydzielić co najmniej 1 024 znaki do tego bufora.

Jeśli wszOutConnectString jest NULL, cchConnectStringLen nadal zwraca łączną liczbę znaków (z wyłączeniem znaku zakończenia zera dla danych znaków) dostępnych do zwrócenia w buforze wskazanym przez wszOutConnectString.

cchConnectStringBuffer
[Input] Długość bufora *wszOutConnectString , w znakach.

cchConnectStringLen
[Wyjście] Wskaźnik do bufora, w którym zwraca się łączna liczba znaków (z wyłączeniem znaku zakończenia zerowego) dostępnych do zwrotu w *wszOutConnectString. Jeśli liczba znaków dostępnych do zwrotu jest większa lub równa cchConnectStringBuffer, ukończony parametry połączenia w *wszOutConnectString jest obcięty do cchConnectStringBuffer minus długość znaku zakończenia zerowego.

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Podobnie jak SQLDriverConnect dla błędów walidacji danych, z tą różnicą, że Driver Manager używa HandleType SQL_HANDLE_DBC_INFO_TOKEN oraz HandlehDbcInfoToken.

Remarks

Driver Manager gwarantuje, że nadrzędne HENV dla hDbc i hDbcInfoToken są takie same.

W przeciwieństwie do SQLDriverConnect, nie ma argumentu DriverCompletion zachęcającego użytkowników do wprowadzenia informacji o połączeniu. W scenariuszu poolingu dialog z promptingiem jest zabroniony.

Aplikacje nie powinny wywoływać tej funkcji bezpośrednio. Sterownik ODBC wspierający pulowanie połączeń świadomych sterowników musi implementować tę funkcję.

Za każdym razem, gdy sterownik zwraca SQL_ERROR lub SQL_INVALID_HANDLE, Driver Manager zwraca błąd do aplikacji (w SQLConnect lub SQLDriverConnect).

Za każdym razem, gdy sterownik zwraca SQL_SUCCESS_WITH_INFO, Driver Manager pobiera informacje diagnostyczne z hDbcInfoToken i zwraca SQL_SUCCESS_WITH_INFO do aplikacji w SQLConnect i SQLDriverConnect.

Gdy aplikacja używa SQLConnect, wszOutConnectString będzie buforem NULL (ostatnie trzy parametry są ustawione na NULL, 0, NULL). W przeciwnym razie sterownik musi zwrócić wyjściowy parametry połączenia, który zostanie zwrócony do wywołania funkcji SQLDriverConnect aplikacji.

Uwzględnij sqlspi.h do tworzenia sterowników ODBC.

Treści powiązane

  • Last updated on