SQLSetConnectInfo-Funktion

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

Summary
SQLSetConnectInfo wird verwendet, um die Datenquelle, Benutzer-ID und das Passwort in das Verbindungs-Info-Token für den SQLConnect-Aufruf einer Anwendung einzulegen.

Syntax

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );

Argumente

TokenHandle
[Eingabe] Token-Handle.

ServerName
[Eingabe] Name der Datenquelle. Die Daten können sich auf demselben Computer befinden wie das Programm oder auf einem anderen Computer irgendwo in einem Netzwerk. Informationen darüber, wie eine Anwendung eine Datenquelle auswählt, finden Sie unter Wahl einer Datenquelle oder eines Treibers.

NameLength1
[Eingabe] Länge von *ServerName in Zeichen.

UserName
[Eingabe] Benutzerkennung.

NameLength2
[Eingabe] Länge von *BenutzerName in Zeichen.

Authentifizierung
[Eingabe] Authentifizierungsstring (typischerweise das Passwort).

NameLength3
[Eingabe] Länge der *Authentifizierung in Zeichen.

Rücklieferungen

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnostics

Dasselbe wie SQLConnect für Eingabevalidierungsfehler, 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