Zuordnen von Handles und Herstellen einer Verbindung mit SQL Server (ODBC)
Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
So ordnen Sie Handles zu und stellen eine Verbindung mit SQL Server her
Schließen Sie die ODBC-Headerdateien Sql.h, Sqlext.h und Sqltypes.h ein.
Fügen Sie die SQL Server treiberspezifische Headerdatei Odbcss.h ein.
Rufen Sie SQLAllocHandle mit einem HandleType von SQL_HANDLE_ENV auf, um ODBC zu initialisieren und ein Umgebungshandle zuzuweisen.
Rufen Sie SQLSetEnvAttr auf, wobei Attribut auf SQL_ATTR_ODBC_VERSION und ValuePtr auf SQL_OV_ODBC3 festgelegt ist, um anzugeben, dass die Anwendung Funktionsaufrufe im ODBC 3.x-Format verwendet.
Rufen Sie optional SQLSetEnvAttr auf, um andere Umgebungsoptionen festzulegen, oder rufen Sie SQLGetEnvAttr auf, um Umgebungsoptionen abzurufen.
Rufen Sie SQLAllocHandle mit einem HandleType von SQL_HANDLE_DBC auf, um ein Verbindungshandle zuzuweisen.
Rufen Sie optional SQLSetConnectAttr auf, um Verbindungsoptionen festzulegen, oder rufen Sie SQLGetConnectAttr auf, um Verbindungsoptionen abzurufen.
Rufen Sie SQLConnect auf, um eine vorhandene Datenquelle zum Herstellen einer Verbindung mit SQL Server zu verwenden.
oder
Rufen Sie SQLDriverConnect auf, um eine Verbindungszeichenfolge zum Herstellen einer Verbindung mit SQL Server zu verwenden.
Eine mindestens vollständige SQL Server Verbindungszeichenfolge weist eine von zwei Formen auf:
DSN=dsn_name;Trusted_connection=yes; DRIVER={SQL Server Native Client 10.0};SERVER=server;Trusted_connection=yes;
Wenn die Verbindungszeichenfolge nicht vollständig ist, kann SQLDriverConnect die erforderlichen Informationen einfordern. Dies wird durch den für den DriverCompletion-Parameter angegebenen Wert gesteuert.
- oder -
Rufen Sie SQLBrowseConnect mehrmals iterativ auf, um die Verbindungszeichenfolge zu erstellen und eine Verbindung mit SQL Server herzustellen.
Rufen Sie optional SQLGetInfo auf, um Treiberattribute und -verhalten für die SQL Server Datenquelle abzurufen.
Ordnen Sie Anweisungen zu und verwenden Sie sie.
Rufen Sie SQLDisconnect auf, um die Verbindung mit SQL Server zu trennen und das Verbindungshandle für eine neue Verbindung verfügbar zu machen.
Rufen Sie SQLFreeHandle mit einem HandleType von SQL_HANDLE_DBC auf, um das Verbindungshandle frei zu geben.
Rufen Sie SQLFreeHandle mit einem HandleType von SQL_HANDLE_ENV auf, um das Umgebungshandle frei zu geben.
Wichtig
Verwenden Sie nach Möglichkeit die Windows-Authentifizierung. Wenn die Windows-Authentifizierung nicht verfügbar ist, fordern Sie die Benutzer auf, ihre Anmeldeinformationen zur Laufzeit einzugeben. Die Anmeldeinformationen sollten nicht in einer Datei gespeichert werden. Wenn Sie die Anmeldeinformationen permanent speichern müssen, verschlüsseln Sie sie mit der Win32 Crypto-API.
Beispiel
Dieses Beispiel zeigt einen Aufruf von SQLDriverConnect, um eine Verbindung mit einer Instanz von SQL Server herzustellen, ohne dass eine vorhandene ODBC-Datenquelle erforderlich ist. Durch Übergeben einer unvollständigen Verbindungszeichenfolge an SQLDriverConnect bewirkt dies, dass der ODBC-Treiber den Benutzer zur Eingabe der fehlenden Informationen auffordert.
#define MAXBUFLEN 255
SQLHENV henv = SQL_NULL_HENV;
SQLHDBC hdbc1 = SQL_NULL_HDBC;
SQLHSTMT hstmt1 = SQL_NULL_HSTMT;
SQLCHAR ConnStrIn[MAXBUFLEN] =
"DRIVER={SQL Server Native Client 10.0};SERVER=MyServer";
SQLCHAR ConnStrOut[MAXBUFLEN];
SQLSMALLINT cbConnStrOut = 0;
// Make connection without data source. Ask that driver
// prompt if insufficient information. Driver returns
// SQL_ERROR and application prompts user
// for missing information. Window handle not needed for
// SQL_DRIVER_NOPROMPT.
retcode = SQLDriverConnect(hdbc1, // Connection handle
NULL, // Window handle
ConnStrIn, // Input connect string
SQL_NTS, // Null-terminated string
ConnStrOut, // Address of output buffer
MAXBUFLEN, // Size of output buffer
&cbConnStrOut, // Address of output length
SQL_DRIVER_PROMPT);
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für