Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der ODBC-Treiber des nativen SQL Server-Clients definiert treiberspezifische Verbindungsattribute. Einige der Attribute stehen zur SQLGetConnectAttrVerfügung, und die Funktion wird verwendet, um ihre aktuellen Einstellungen zu melden. Die für diese Attribute gemeldeten Werte sind erst garantiert, nachdem eine Verbindung hergestellt wurde oder das Attribut mit SQLSetConnectAttr festgelegt wurde.
In diesem Thema werden die schreibgeschützten Attribute aufgeführt. Informationen zu den anderen SQL Server Native Client ODBC-treiberspezifischen Verbindungsattributen finden Sie unter SQLSetConnectAttr.
SQL_COPT_SS_CONNECTION_DEAD
Das attribut SQL_COPT_SS_CONNECTION_DEAD meldet den Status einer Verbindung mit einem Server. Der Treiber fragt das Netzwerk nach dem aktuellen Status der Verbindung ab.
Hinweis
Das Standardmäßige ODBC-Verbindungsattribute SQL_ATTR_CONNECTION_DEAD gibt den letzten Status der Verbindung zurück. Dies ist möglicherweise nicht der aktuelle Verbindungsstatus.
| Wert | BESCHREIBUNG |
|---|---|
| SQL_CD_TRUE | Die Verbindung mit dem Server ist verloren gegangen. |
| SQL_CD_FALSE | Die Verbindung ist geöffnet und für die Verarbeitung von Anweisungen verfügbar. |
SQL_COPT_SS_CLIENT_CONNECTION_ID
Das attribut SQL_COPT_SS_CLIENT_CONNECTION_ID ruft die Clientverbindungs-ID ab, die dann zum Suchen verwendet werden kann:
Diagnoseinformationen im XEvents-Protokoll, wenn aktiviert.
Verbindungsfehlerinformationen im Verbindungsringpuffer.
Diagnoseinformationen in den Datenzugriffsablaufverfolgungsprotokollen, wenn diese aktiviert sind.
Weitere Informationen finden Sie unter Zugreifen auf Diagnoseinformationen im Protokoll für erweiterte Ereignisse.
| Wert | BESCHREIBUNG |
|---|---|
| SQL_ERROR | Fehler bei der Verbindung. |
| SQL_SUCCESS | Die Verbindung war erfolgreich. Die Clientverbindungs-ID wird im Ausgabepuffer gefunden. |
SQL_COPT_SS_PERF_DATA
Das attribut SQL_COPT_SS_PERF_DATA gibt einen Zeiger auf eine SQLPERF-Struktur zurück, die die aktuellen Treiberleistungsstatistiken enthält.
SQLGetConnectAttr gibt NULL zurück, wenn die Leistungsprotokollierung nicht aktiviert ist. Die Statistiken in der SQLPERF-Struktur werden vom Treiber nicht dynamisch aktualisiert. Rufen Sie jedes Mal auf SQLGetConnectAttr , wenn die Leistungsstatistiken aktualisiert werden müssen.
| Wert | BESCHREIBUNG |
|---|---|
| NULL | Die Leistungsprotokollierung ist nicht aktiviert. |
| Jeder andere Wert | Ein Zeiger auf eine SQLPERF-Struktur. |
SQL_COPT_SS_PERF_QUERY
Das attribut SQL_COPT_SS_PERF_QUERY gibt TRUE zurück, wenn die Protokollierung von lang ausgeführten Abfragen aktiviert ist. Die Anforderung gibt FALSE zurück, wenn die Abfrageprotokollierung nicht aktiv ist.
SQL_COPT_SS_USER_DATA
Das attribut SQL_COPT_SS_USER_DATA ruft den Benutzerdatenzeiger ab. Benutzerdaten werden im clienteigenen Speicher gespeichert und pro Verbindung aufgezeichnet. Wenn der Benutzerdatenzeiger nicht festgelegt wurde, wird SQL_UD_NOTSET, ein NULL-Zeiger, zurückgegeben.
| Wert | BESCHREIBUNG |
|---|---|
| SQL_UD_NOTSET | Es ist kein Benutzerdatenzeiger festgelegt. |
| Jeder andere Wert | Ein Zeiger auf die Benutzerdaten. |
SQLGetConnectAttr-Unterstützung für Dienstprinzipalnamen (SPNs)
SQLGetConnectAttr kann verwendet werden, um den Wert der neuen Verbindungsattribute SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED und SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD abzufragen. (SQLGetConnectOption kann auch zum Abfragen dieser Werte verwendet werden.)
SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ist nur für offene Verbindungen verfügbar, die die Windows-Authentifizierung verwenden.
Wenn SQL_COPT_SS_SERVER_SPN oder SQL_COPT_SS_FAILOVER_PARTNER nicht festgelegt wurde, wird der Standardwert (eine leere Zeichenfolge) zurückgegeben.
Weitere Informationen zu SPNs finden Sie unter Service Principal Names (SPNs) in Client Connections (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Connections (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Connections (ODBC).
Siehe auch
SQLGetConnectAttr-Funktion
ODBC-API-Implementierungsdetails
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)