SQLGetPoolID, funkcja

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

Podsumowanie
SQLGetPoolID pobiera identyfikator puli.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Input] Uchwyt tokena zawierający wszystkie informacje o połączeniu.

pPoolID
[Wyjście] ID puli, który służy do identyfikacji zestawu połączeń, które można używać zamiennie (co może wymagać dodatkowego resetu).

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Gdy SQLGetPoolID zwraca SQL_ERROR lub SQL_SUCCESS_WITH_INFO, Driver Manager użyje HandleType SQL_HANDLE_DBC_INFO_TOKEN oraz HandlehDbcInfoToken.

Remarks

SQLGetPoolID służy do uzyskania identyfikatora puli na podstawie zestawu informacji o połączeniu (z SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectinfo i SQLSetConnectInfo). Ten identyfikator puli służy do identyfikacji zestawu połączeń, które mogą być używane zamiennie (co może wymagać dodatkowego resetu). ID puli będzie używany do identyfikacji puli połączeń dla tej grupy połączeń.

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.

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