SQLSetConnectInfo-Funktion

Artikel
05/23/2023

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

Zusammenfassung
SQLSetConnectInfo wird verwendet, um die Datenquelle, die Benutzer-ID und das Kennwort im Verbindungsinformationstoken für den SQLConnect-Aufruf einer Anwendung festzulegen.

Syntax

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

Argumente

TokenHandle
[Eingabe] Tokenhandle.

ServerName
[Eingabe] Datenquellenname. Die Daten befinden sich möglicherweise auf demselben Computer wie das Programm oder auf einem anderen Computer irgendwo in einem Netzwerk. Informationen dazu, wie eine Anwendung eine Datenquelle auswählt, finden Sie unter Auswählen einer Datenquelle oder eines Treibers.

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

UserName
[Eingabe] Benutzer-ID.

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

Authentifizierung
[Eingabe] Authentifizierungszeichenfolge (in der Regel das Kennwort).

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

Gibt zurück

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnose

Identisch mit SQLConnect für Eingabevalidierungsfehler, 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

Teilen über