SQLPoolConnect-Funktion

Konformität
Eingeführte Version: ODBC 3.8 Normeneinhaltung: ODBC

Summary
SQLPoolConnect wird verwendet, um eine neue Verbindung zu erstellen, wenn keine Verbindung im Pool wiederverwendet werden kann.

Syntax

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

Argumente

hDbc
[Eingabe] Der Verbindungsgriff.

hDbcInfoToken
[Eingabe] Der Token-Handle für die neue Anwendungsverbindungsanfrage.

wszOutConnectString
[Ausgabe] Zeiger auf einen Puffer für den fertigen Verbindungszeichenfolge. Nach erfolgreicher Verbindung zur Zieldatenquelle enthält dieser Puffer die abgeschlossene Verbindungszeichenfolge. Anwendungen sollten mindestens 1.024 Zeichen für diesen Puffer zuweisen.

Wenn wszOutConnectString NULL ist, gibt cchConnectStringLen dennoch die Gesamtzahl der Zeichen zurück (ohne das Null-Terminationszeichen für Zeichendaten), die im von wszOutConnectString gezeigten Puffer zurückgegeben werden können.

cchConnectStringBuffer
[Eingabe] Länge des *wszOutConnectString-Puffers , in Zeichen.

cchConnectStringLen
[Ausgabe] Zeiger auf einen Puffer, in dem die Gesamtzahl der Zeichen (ohne das Null-Terminationszeichen) zurückgegeben werden kann, die in *wszOutConnectString zurückgegeben werden können. Wenn die Anzahl der zurückgegebenen Zeichen größer oder gleich cchConnectStringBuffer ist, wird die abgeschlossene Verbindungszeichenfolge in *wszOutConnectString zu cchConnectStringBuffer minus der Länge eines Null-Terminationszeichens abgeschnitten.

Rücklieferungen

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnostics

Ähnlich wie SQLDriverConnect bei jeder Eingabevalidierungsfehler, mit dem Unterschied, dass der Treibermanager einen HandleType von SQL_HANDLE_DBC_INFO_TOKEN und einen Handle von hDbcInfoToken verwendet.

Bemerkungen

Der Driver Manager garantiert, dass der übergeordnete HENV-Handle von hDbc und hDbcInfoToken identisch ist.

Im Gegensatz zu SQLDriverConnect gibt es kein DriverCompletement-Argument , das Benutzer auffordert, Verbindungsinformationen einzugeben. Ein Prompting-Dialog ist im Pooling-Szenario nicht erlaubt.

Anwendungen sollten diese Funktion nicht direkt aufrufen. Ein ODBC-Treiber, der treiberbewusstes Connection Pooling unterstützt, muss diese Funktion implementieren.

Wann immer ein Treiber SQL_ERROR oder SQL_INVALID_HANDLE zurückgibt, gibt der Treibermanager den Fehler an die Anwendung zurück (in SQLConnect oder SQLDriverConnect).

Wann immer ein Treiber SQL_SUCCESS_WITH_INFO zurückgibt, erhält der Treibermanager die Diagnoseinformationen von hDbcInfoToken und gibt SQL_SUCCESS_WITH_INFO in SQLConnect und SQLDriverConnect an die Anwendung zurück.

Wenn eine Anwendung SQLConnect verwendet, ist wszOutConnectString ein NULL-Puffer (die letzten drei Parameter werden alle auf NULL, 0, NULL gesetzt). Andernfalls muss der Treiber die Ausgabe-Verbindungszeichenfolge zurückgeben, die dann an den SQLDriverConnect Function-Aufruf der Anwendung zurückgegeben wird.

Fügen Sie sqlspi.h für die Entwicklung von ODBC-Treibern hinzu.

Verwandte Inhalte

  • Last updated on