Udostępnij za pośrednictwem


SQLGetConnectAttr

The SQL Server Native klient ODBC driver defines driver-specific connection attributes. Niektóre atrybuty są dostępne dla SQLGetConnectAttri funkcja jest używany w celu zgłoszenia ich bieżących ustawień.Zgłoszone wartości dla tych atrybutów nie jest gwarantowane aż po dokonaniu połączenia lub atrybut został zestaw przy użyciu SQLzestawConnectAttr.

Aby uzyskać więcej informacji o atrybutach zobacz SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Atrybut SQL_COPT_SS_CONNECTION_DEAD raportuje stan połączenia z serwerem.Sterownik monituje sieć dla bieżącego stanu połączenia.

Uwaga

Standardowe atrybut połączenia ODBC SQL_ATTR_CONNECTION_DEAD zwraca najnowszych stan połączenia.To może nie być aktualny stan połączenia.

Wartość

Description

SQL_CD_TRUE

Połączenie z serwerem zostało utracone.

SQL_CD_FALSE

Połączenie jest otwarte i dostępne do przetwarzania instrukcja.

SQL_COPT_SS_PERF_DATA

Atrybut SQL_COPT_SS_PERF_DATA zwraca wskaźnik do struktury SQLPERF zawierające bieżące statystyki wydajności sterownika.SQLGetConnectAttr zwróci wartość NULL, jeśli nie jest włączone rejestrowanie wydajności.Statystyka w strukturze SQLPERF nie są aktualizowane dynamicznie przez sterownik.Wywołanie SQLGetConnectAttr za każdym razem statystyki wydajności musi zostać odświeżona.

Wartość

Description

WARTOŚCI NULL

Nie włączono rejestrowania wydajności.

Każda inna wartość

Wskaźnik do struktury SQLPERF.

SQL_COPT_SS_PERF_QUERY

Atrybut SQL_COPT_SS_PERF_QUERY zwraca wartość TRUE, jeśli jest włączone rejestrowanie długo działających kwerendy.Żądanie zwraca wartość FALSE, jeśli rejestrowanie kwerendy nie jest aktywny.

SQL_COPT_SS_USER_DATA

Atrybut SQL_COPT_SS_USER_DATA pobiera wskaźnik danych użytkownika.Dane użytkownika są przechowywane w pamięci będących własnością klient i rejestrowane na połączenie.Jeśli wskaźnik danych użytkownika nie została zestaw, SQL_UD_NOT zestaw, zwracana jest wartość NULL, wskaźnik.

Wartość

Description

SQL_UD_NOTSET

Wskaźnik danych użytkownika nie jest zestaw.

Każda inna wartość

Wskaźnik do danych użytkownika.

Obsługa SQLGetConnectAttr główne nazwy usług (SPN)

SQLGetConnectAttr można zbadać wartości nowych atrybutów połączenia SQL_COPT_SS_SERVER_SPN SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED i SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD.(SQLGetConnectOption można również te wartości do kwerendy.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD jest dostępna tylko w przypadku otwartego połączenia, które używają uwierzytelnianie systemu Windows.

Jeśli nie ustawiono SQL_COPT_SS_SERVER_SPN lub SQL_COPT_SS_FAILOVER_PARTNER, zwracana jest wartość domyślna (pusty ciąg).

Aby uzyskać więcej informacji na temat nazwy SPN zobacz Główne nazwy usług (SPN) w oknie klient połączenia (ODBC).