SQLCleanupConnectionPoolID, funkcja

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

Podsumowanie
SQLCleanupConnectionPoolID informuje sterownik, że identyfikator puli został przeterminowany. ID puli może wygasać za każdym razem, gdy wszystkie połączenia w puli powiązanej z tym ID puli zostały wygaszone. Więcej informacji o timeoutach połączenia można znaleźć w sekcji Pooling in the Microsoft Data Access Components.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Arguments

EnvironmentHandle
[Input] Zarządzanie środowiskiem w puli.

PoolID
[Input] Pula powiązana z identyfikatorem puli została wygasła.

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Driver Manager nie przetwarza informacji diagnostycznych zwróconych z SQLCleanupConnectionPoolID.

Aplikacja nie może otrzymać komunikatu o błędzie zwróconego przez sterownik.

Remarks

SQLCleanupConnectionPoolID można wywołać w dowolnym momencie, ale Driver Manager gwarantuje, że żaden inny wątek jednocześnie nie wywołuje SQLGetPoolID i żaden inny wątek jednocześnie nie wywołuje SQLRateConnection i SQLPoolConnect z tokenem informacji o połączeniu przypisanym do tego identyfikatora puli. Dlatego sterownik musi upewnić się, że funkcja ta jest bezpieczna dla wątków.

Sterownik może oczyścić zasoby powiązane z identyfikatorem puli.

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

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

Treści powiązane

  • Last updated on