SQLDriverConnect

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Der ODBC-Treiber für SQL Server Native Client definiert Verbindungsattribute, die Verbindungszeichenfolgen Schlüsselwort (keyword) ersetzen oder verbessern. Mehrere Verbindungszeichenfolgen-Schlüsselwort (keyword) weisen Standardwerte auf, die vom SQL Server Native Client ODBC-Treiber angegeben werden.

Eine Liste der im SQL Server Native Client ODBC-Treiber verfügbaren Schlüsselwort (keyword) finden Sie unter Verwenden von Verbinden ion-Zeichenfolgenstichwörtern mit SQL Server Native Client.

Weitere Informationen zu SQL Server-Verbindungsattributen und Treiberstandardverhalten finden Sie unter SQLSet Verbinden Attr.

Eine Erläuterung zu Verbindungszeichenfolge Schlüsselwort (keyword), die für SQL Server Native Client gültig sind, finden Sie unter Verwenden von Verbinden ion-Zeichenfolgenstichwörtern mit SQL Server Native Client.

Wenn der SQLDriver Verbinden DriverCompletion-Parameterwert SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE oder SQL_DRIVER_COMPLETE_REQUIRED ist, ruft der SQL Server Native Client ODBC-Treiber Schlüsselwort (keyword) Werte aus dem angezeigten Dialogfeld ab. Wenn der Schlüsselwort (keyword) Wert im Verbindungszeichenfolge übergeben wird und der Benutzer den Wert für die Schlüsselwort (keyword) im Dialogfeld nicht ändert, verwendet der SQL Server Native Client ODBC-Treiber den Wert aus dem Verbindungszeichenfolge. Wenn der Wert in der Verbindungszeichenfolge nicht festgelegt wird und der Benutzer keine Zuweisung im Dialogfeld vornimmt, verwendet der Treiber den Standardwert.

SQLDriver Verbinden muss ein gültiges WindowHandle-Element erhalten, wenn für jeden DriverCompletion-Wert die Anzeige des Dialogfelds "Treiberverbindung" erforderlich ist (oder erforderlich sein kann). Ein ungültiges Handle gibt SQL_ERROR zurück.

Geben Sie entweder das Schlüsselwort DRIVER oder DSN an. ODBC gibt an, dass ein Treiber das äußere linke dieser beiden Schlüsselwörter verwendet und das andere ignoriert, wenn beide Schlüsselwörter angegeben sind. Wenn DRIVER angegeben ist oder die äußerst linke Seite der beiden ist, und der SQLDriver Verbinden DriverCompletion-Parameterwert SQL_DRIVER_NOPROMPT ist, sind die SERVER-Schlüsselwort (keyword) und ein entsprechender Wert erforderlich.

Wenn SQL_DRIVER_NOPROMPT angegeben wird, müssen Schlüsselwörter für die Benutzerauthentifizierung mit Werten vorhanden sein. Der Treiber stellt sicher, dass entweder die Zeichenfolge "Trusted_Connection=yes" oder sowohl das UID- als auch das PWD-Schlüsselwort vorhanden sind.

Wenn der Parameterwert "DriverCompletion" SQL_DRIVER_NOPROMPT oder SQL_DRIVER_COMPLETE_REQUIRED ist und die Sprache oder Datenbank aus dem Verbindungszeichenfolge stammt und entweder ungültig ist, gibt SQLDriver Verbinden SQL_ERROR zurück.

Wenn der Parameterwert "DriverCompletion" SQL_DRIVER_NOPROMPT oder SQL_DRIVER_COMPLETE_REQUIRED ist und die Sprache oder Datenbank aus den ODBC-Datenquellendefinitionen stammt und entweder ungültig ist, verwendet SQLDriver Verbinden die Standardsprache oder Datenbank für die angegebene Benutzer-ID und gibt SQL_SUCCESS_WITH_INFO zurück.

Wenn der Parameterwert "DriverCompletion" SQL_DRIVER_COMPLETE oder SQL_DRIVER_PROMPT ist und wenn die Sprache oder Datenbank ungültig ist, zeigt SQLDriver Verbinden das Dialogfeld erneut an.

SQLDriverConnect-Unterstützung für hohe Verfügbarkeit, Wiederherstellung im Notfall

Weitere Informationen zur Verwendung von SQLDriver Verbinden zum Herstellen einer Verbindung mit einem Always On-Verfügbarkeitsgruppencluster finden Sie unter SQL Server Native Client Support for High Availability, Disaster Recovery.

SQLDriverConnect-Unterstützung für Dienstprinzipalnamen (Service Principal Names, SPNs)

SQLDDriver Verbinden verwendet das Dialogfeld "ODBC-Anmeldung", wenn die Eingabeaufforderung aktiviert ist. Damit können SPNs sowohl für den Prinzipalserver als auch für seinen Failoverpartner eingegeben werden.

SQLDriver Verbinden akzeptiert die neuen Verbindungszeichenfolge Schlüsselwort (keyword)s ServerSPN und FailoverPartnerSPN und erkennt die neuen Verbindungsattribute SQL_COPT_SS_SERVER_SPN und SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Wenn ein Wert für ein Verbindungsattribut mehrfach angegeben wird, hat ein programmgesteuert festgelegter Wert Vorrang vor dem Wert in einem DSN und einem Wert in einer Verbindungszeichenfolge. Ein Wert in einem DSN hat Vorrang vor einem Wert in einer Verbindungszeichenfolge.

Wenn eine Verbindung geöffnet wird, legt SQL Server Native Client SQL_COPT_SS_MUTUALLY_AUTHENTICATED und SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD auf die Authentifizierungsmethode fest, die zum Öffnen der Verbindung verwendet wird.

Weitere Informationen zu SPNs finden Sie unter Service Principal Names (SPNs) in Client Verbinden ions (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Verbinden ions (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Verbinden ions (ODBC).

Beispiele

Der folgende Aufruf veranschaulicht die geringste Datenmenge, die für SQLDriver erforderlich ist Verbinden:

SQLDriverConnect(hdbc, hwnd,  
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,  
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);  

Die folgenden Verbindungszeichenfolge veranschaulichen mindestens erforderliche Daten, wenn der Parameterwert "DriverCompletion" SQL_DRIVER_NOPROMPT ist:

"DSN=Human Resources;Trusted_Connection=yes"  
  
"FILEDSN=HR_FDSN;Trusted_Connection=yes"  
  
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"  

Weitere Informationen

SQLDriverConnect-Funktion
ODBC-API-Implementierungsdetails
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)