SQLSetDriverConnectInfo-Funktion

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

Summary
SQLSetDriverConnectInfo wird verwendet, um die Verbindungszeichenfolge in das Connection Info-Token für den SQLDriverConnect-Aufruf einer Anwendung einzustellen.

Syntax

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

Argumente

TokenHandle
[Eingabe] Token-Handle.

InConnectionString
[Eingabe] Ein vollständiger Verbindungszeichenfolge (siehe die Syntax in "Comments" in SQLDriverConnect), ein partieller Verbindungszeichenfolge oder ein leerer String.

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

Rücklieferungen

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnostics

Dasselbe gilt für SQLDriverConnect im Zusammenhang mit Eingabevalidierungsfehlern, nur dass der Treibermanager einen HandleType von SQL_HANDLE_DBC_INFO_TOKEN und einen Handle von hDbcInfoToken verwendet.

Bemerkungen

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.

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

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

Verwandte Inhalte

  • Last updated on