Udostępnij za pośrednictwem


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:

  • "NTLM", która jest zwracana, gdy połączenie jest otwarte przy użyciu uwierzytelnianie NTLM.

  • "Kerberos", która jest zwracana, gdy połączenie jest otwarte przy użyciu uwierzytelnianie Kerberos.

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:

Zobacz także

Koncepcje