Główne nazwy usług (SPN) w połączeń klienta (ODBC)
W tym temacie opisano atrybuty ODBC i funkcji obsługujących główne nazwy usługa (SPN) w klient aplikacji.Aby uzyskać więcej informacji dotyczących nazwy SPN w klient aplikacji, zobacz Obsługa głównej nazwy usługi (główna nazwa usługi) w połączeń klientów.
Słowa kluczowe ciąg połączenia
Następujące połączenia ciąg słowa kluczowe umożliwić aplikacjom klienckim określić nazwy główna nazwa usługi.
Słowo kluczowe |
Wartość |
|---|---|
ServerSPN |
Nazwy główna nazwa usługi serwera.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Native Client, aby użyć domyślnego, generowane sterownik główna nazwa usługi. |
FailoverPartnerSPN |
Nazwa główna nazwa usługi partner pracy awaryjnej.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Native Client, aby użyć domyślnego, generowane sterownik główna nazwa usługi. |
Atrybuty połączenia
Włącz następujące atrybuty połączenia klient aplikacji, aby określić nazwy główna nazwa usługi i kwerendy dla metoda uwierzytelnianie.
Nazwa |
Typ |
Użycie |
|---|---|---|
SQL_COPT_SS_SERVER_SPN SQL_COPT_SS_FAILOVER_PARTNER_SPN |
SQLTCHAR, Odczyt i zapis |
Określa nazwę główna nazwa usługi serwera.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Native Client, aby użyć domyślnego, generowane sterownik główna nazwa usługi. Ten atrybut może przeszukiwać tylko po zestaw programowo, lub po otwarciu połączenia.Jeśli próby kwerendy ten atrybut połączenia, który nie jest otwarty, a atrybut nie został zestaw programowo, zwracana jest wartość SQL_ERROR i diagnostycznych rekord rejestrowany jest SQLState 08003 i komunikat "Nie jest otwarte połączenie". Jeśli próby ten atrybut ustawiony, gdy połączenie jest otwarte, zwracana jest wartość SQL_ERROR i diagnostycznych rekord rejestrowany jest z SQLState HY011 i komunikat "nieprawidłowy w tej operacji czas". |
SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD |
SQLTCHAR, tylko do odczytu |
Zwraca metoda uwierzytelnianie używana dla połączenia.Wartość zwracana do aplikacji jest wartość, która zwraca Windows SQL Server macierzystego klienta.Możliwe wartości to:
Ten atrybut mogą być odczytywane tylko otwarte połączenie używane uwierzytelnianie systemu Windows.Jeśli próby ją przeczytać, zanim połączenie zostanie otwarty, zwracana jest wartość SQL_ERROR i SQLState 08003 i komunikat "Nie jest otwarte połączenie" zostanie zarejestrowany błąd. Jeśli ten atrybut jest badane na połączenie bez użycia uwierzytelniania systemu Windows, zwracana jest wartość SQL_ERROR, a błąd jest rejestrowany z SQLState HY092 i komunikat "nieprawidłowy atrybutu/opcji Identyfikator" (SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD jest dostępna tylko dla połączeń zaufane). Jeśli uwierzytelnianie metoda nie można ustalić, zwracana jest wartość SQL_ERROR, a błąd jest rejestrowany z SQLState HY000 i komunikat "Błąd ogólny". |
SQL_COPT_SS_MUTUALLY_AUTHENTICATED |
SQLSMALLINT, tylko do odczytu |
Zwraca SQL_TRUE, jeśli serwer w połączeniu wzajemnie został uwierzytelniony; w przeciwnym razie zwraca wartość SQL_FALSE. Atrybut ten można odczytać tylko dla otwartego połączenia.Jeśli próby ją przeczytać, zanim połączenie zostanie otwarty, zwracana jest wartość SQL_ERROR i SQLState 08003 i komunikat "Nie jest otwarte połączenie" zostanie zarejestrowany błąd. Jeśli ten atrybut jest badany pod kątem połączenie bez użycia uwierzytelniania systemu Windows, zwracany jest SQL_FALSE. |
Określanie nazwy SPN obsługi funkcji ODBC
ODBC następujące funkcje obsługi klient aplikacji i SPN: