Udostępnij za pośrednictwem


SQLGetConnectAttr

SQL Server Sterownik ODBC macierzystym klienta definiuje atrybuty specyficzne dla sterownika połączenia.Niektóre atrybuty są dostępne dla SQLGetConnectAttr, i ta funkcja służy do zgłaszania ich bieżące ustawienia.Podać wartości dla tych atrybutów nie są gwarantowane aż po połączeniu lub atrybut został zestaw za pomocą SQLzestawConnectAttr.

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

SQL_COPT_SS_CONNECTION_DEAD

Atrybut SQL_COPT_SS_CONNECTION_DEAD raportuje stan połączenia z serwerem.Sterownik kwerendy sieci dla bieżącego stanu połączenia.

Ostrzeżenie

Standard ODBC atrybut połączenia SQL_ATTR_CONNECTION_DEAD zwraca najnowsze stan połączenia.Może być bieżący stan połączenia.

Wartość

Opis

SQL_CD_TRUE

Połączenie z serwerem zostało utracone.

SQL_CD_FALSE

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

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 włączono rejestrowanie wydajności.Statystyki w strukturze SQLPERF nie są aktualizowane dynamicznie przez sterownik.Wywołanie SQLGetConnectAttr każdego czas statystyki wydajności wymagają odświeżenia.

Wartość

Opis

NULL

Nie włączono rejestrowanie wydajności.

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ługotrwałe 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 jest przechowywane w pamięci własnością klient i zarejestrowana na połączenie.Jeśli wskaźnik danych użytkownika nie została zestaw, SQL_UD_NOTzestaw, wskaźnik NULL, zostanie zwrócona.

Wartość

Opis

SQL_UD_NOTSET

Wskaźnik danych użytkownika nie jest zestaw.

Inna wartość

Wskaźnik do danych użytkownika.

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

SQLGetConnectAttr można zbadać wartości nowe atrybuty 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że również służyć do kwerendy tych wartości.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD jest dostępna tylko dla otwarte połączenia, które korzystają z uwierzytelniania systemu Windows.

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

Aby uzyskać więcej informacji dotyczących nazwy SPN, zobacz Główne nazwy usług (SPN) w połączeń klienta (ODBC).