Freigeben über


SQLGetConnectAttr

Der SQL Server Native Client ODBC-Treiber definiert treiberspezifische Verbindungsattribute. Einige der Attribute sind für SQLGetConnectAttr verfügbar, und die Funktion dient zum Melden ihrer aktuellen Einstellungen. Die für diese Attribute gemeldeten Werte sind erst garantiert, nachdem eine Verbindung hergestellt wurde oder das Attribut mithilfe von SQLSetConnectAttr festgelegt wurde.

Weitere Informationen über Attribute finden Sie unter SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Das SQL_COPT_SS_CONNECTION_DEAD-Attribut meldet den Status einer Verbindung zu einem Server. Der Treiber sendet eine Abfrage an das Netzwerk bezüglich des aktuellen Status der Verbindung.

HinweisHinweis

Das Standard-ODBC-Verbindungsattribut SQL_ATTR_CONNECTION_DEAD gibt den letzten Status der Verbindung zurück. Dabei handelt es sich nicht zwingend um den aktuellen Verbindungsstatus.

Wert

Beschreibung

SQL_CD_TRUE

Die Verbindung zum Server wurde unterbrochen.

SQL_CD_FALSE

Die Verbindung besteht und ist für die Anweisungsverarbeitung verfügbar.

SQL_COPT_SS_PERF_DATA

Das SQL_COPT_SS_PERF_DATA-Attribut gibt einen Zeiger auf eine SQLPERF-Struktur zurück, die die aktuellen statistischen Daten zur Treiberleistung enthält. SQLGetConnectAttr gibt NULL zurück, wenn die Leistungsprotokollierung nicht aktiviert ist. Die Statistik in der SQLPERF-Struktur wird nicht dynamisch vom Treiber aktualisiert. Rufen Sie jedes Mal, wenn die Leistungsstatistik aktualisiert werden muss, SQLGetConnectAttr auf.

Wert

Beschreibung

NULL

Die Leistungsprotokollierung wird nicht aktiviert.

Ein beliebiger anderer Wert.

Ein Zeiger auf eine SQLPERF-Struktur.

SQL_COPT_SS_PERF_QUERY

Das SQL_COPT_SS_PERF_QUERY-Attribut gibt TRUE zurück, wenn die Protokollierung von Abfragen mit langer Ausführungszeit aktiviert ist. Die Anforderung gibt FALSE zurück, wenn die Abfrageprotokollierung nicht aktiv ist.

SQL_COPT_SS_USER_DATA

Das SQL_COPT_SS_USER_DATA-Attribut ruft den Benutzerdatenzeiger ab. Benutzerdaten werden im clienteigenen Arbeitsspeicher 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.

Ein beliebiger anderer 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. (Diese Werte können auch mit SQLGetConnectOption abgefragt werden.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ist nur für bestehende Verbindungen, die die Windows-Authentifizierung verwenden, verfügbar.

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 Dienstprinzipalnamen (SPN) in Clientverbindungen (ODBC).