SQLDriverConnect
Der SQL Native Client-ODBC-Treiber definiert Verbindungsattribute, die entweder Schlüsselwörter für Verbindungszeichenfolgen ersetzen oder verbessern. Mehrere Schlüsselwörter für Verbindungszeichenfolgen verfügen über vom SQL Native Client-ODBC-Treiber angegebene Standardwerte.
Eine Liste der im SQL Native Client-ODBC-Treiber verfügbaren Schlüsselwörter finden Sie unter Using Connection String Keywords with SQL Native Client.
Weitere Informationen zu SQL Server-Verbindungsattributen und Standardverhalten von Treibern finden Sie unter SQLSetConnectAttr.
Wenn der SQLDriverConnectDriverCompletion -Parameterwert auf SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE oder SQL_DRIVER_COMPLETE_REQUIRED festgelegt ist, ruft der SQL Native Client-ODBC-Treiber Werte für Schlüsselwörter aus dem angezeigten Dialogfeld ab. Wenn der Schlüsselwortwert in der Verbindungszeichenfolge übergeben wird und der Benutzer den Schlüsselwortwert nicht im Dialogfeld ändert, verwendet der SQL Native Client-ODBC-Treiber den Wert aus der Verbindungszeichenfolge. Wenn der Wert in der Verbindungszeichenfolge nicht festgelegt wird und der Benutzer keine Zuweisung im Dialogfeld vornimmt, verwendet der Treiber den Standardwert.
SQLDriverConnect muss ein gültiger WindowHandle-Wert zugewiesen werden, wenn ein DriverCompletion-Wert die Anzeige des Verbindungsdialogfelds des Treibers erfordert (oder erfordern könnte). 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 es sich hierbei um das äußere linke der beiden Schlüsselwörter handelt und wenn der SQLDriverConnectDriverCompletion-Parameterwert SQL_DRIVER_NOPROMPT lautet, sind das Schlüsselwort SERVER 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 DriverCompletion-Parameterwert SQL_DRIVER_NOPROMPT oder SQL_DRIVER_COMPLETE_REQUIRED lautet und die Sprache oder Datenbank aus der Verbindungszeichenfolge stammt und ungültig ist, gibt SQLDriverConnect SQL_ERROR zurück.
Wenn der DriverCompletion-Parameterwert SQL_DRIVER_NOPROMPT oder SQL_DRIVER_COMPLETE_REQUIRED lautet und die Sprache oder Datenbank aus den ODBC-Datenquellendefinitionen stammt und ungültig ist, verwendet SQLDriverConnect die standardmäßige Sprache oder Datenbank für die angegebene Benutzer-ID und gibt SQL_SUCCESS_WITH_INFO zurück.
Wenn der DriverCompletion-Parameterwert SQL_DRIVER_COMPLETE oder SQL_DRIVER_PROMPT lautet und die Sprache oder Datenbank ungültig ist, zeigt SQLDriverConnect das Dialogfeld erneut an.
Beispiele
Der folgende Aufruf illustriert die Mindestdatenmenge für SQLDriverConnect:
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
Die folgenden Verbindungszeichenfolgen illustrieren die Mindestdatenmenge, wenn der DriverCompletion -Parameterwert SQL_DRIVER_NOPROMPT lautet:
"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"
"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"
Siehe auch
Konzepte
ODBC API Implementation Details
Andere Ressourcen
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SQLDriveConnect-Funktion