Freigeben über


SQLSetDriverConnectInfo-Funktion

Konformität
Eingeführte Version: ODBC 3.81-Standardkonformität: ODBC

Zusammenfassung
SQLSetDriverConnectInfo wird verwendet, um die Verbindungszeichenfolge im Verbindungsinformationstoken für den SQLDriverConnect-Aufruf einer Anwendung festzulegen.

Syntax

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

Argumente

TokenHandle
[Eingabe] Tokenhandle.

InConnectionString
[Eingabe] Eine vollständige Verbindungszeichenfolge (siehe Syntax in "Kommentare" in SQLDriverConnect), eine partielle Verbindungszeichenfolge oder eine leere Zeichenfolge.

StringLength1
[Eingabe] Länge von *InConnectionString, in Zeichen, wenn die Zeichenfolge Unicode ist, oder Bytes, wenn Zeichenfolge ANSI oder DBCS ist.

Gibt zurück

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnose

Identisch mit SQLDriverConnect im Zusammenhang mit jedem Eingabeüberprüfungsfehler, mit der Ausnahme, dass der Treiber-Manager einen HandleType von SQL_HANDLE_DBC_INFO_TOKEN und ein Handle von hDbcInfoToken verwendet.

Bemerkungen

Wenn ein Treiber SQL_ERROR oder SQL_INVALID_HANDLE zurückgibt, gibt der Treiber-Manager den Fehler an die Anwendung zurück (in SQLConnect oder SQLDriverConnect).

Wenn ein Treiber SQL_SUCCESS_WITH_INFO zurückgibt, ruft der Treiber-Manager die Diagnoseinformationen aus hDbcInfoToken ab und gibt SQL_SUCCESS_WITH_INFO an die Anwendung in SQLConnect und SQLDriverConnect zurück.

Anwendungen sollten diese Funktion nicht direkt aufrufen. Ein ODBC-Treiber, der treiberfähige Verbindungspooling unterstützt, muss diese Funktion implementieren.

Schließen Sie sqlspi.h für die ODBC-Treiberentwicklung ein.

Weitere Informationen

Entwickeln eines ODBC-Treibers
Treiberfähiges Verbindungspooling
Entwickeln von Verbindungspool-Unterstützung in einem ODBC-Treiber