Główne nazwy usług (SPN) w oknie klient połączenia (ODBC)
W tym temacie opisano atrybuty ODBC i funkcje, które obsługują głównej nazwy usługa (SPN) w aplikacji klient.Aby uzyskać więcej informacji na temat nazwy SPN w klient aplikacji, zobacz Obsługa usługa Principal Name (główna nazwa usługi) w programie połączeń klientów.
Słowa kluczowe ciąg połączenia
Włącz następujące słowa kluczowe ciąg połączenia klient aplikacji, aby określić główna nazwa usługi.
Słowo kluczowe |
Wartość |
|---|---|
ServerSPN |
Nazwę główna nazwa usługi serwera.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Macierzysty klient do używania domyślnej, sterownik generowane nazwy główna nazwa usługi. |
FailoverPartnerSPN |
Nazwę główna nazwa usługi partner pracy awaryjnej.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Macierzysty klient do używania domyślnej, sterownik generowane nazwy główna nazwa usługi. |
Atrybuty połączenia
Następujące atrybuty połączenia włączyć aplikacje klienckie do określenia nazwy główna nazwa usługi, a kwerendy w celu uwierzytelnienia.
Imię i nazwisko |
Typ |
Sposób użycia |
|---|---|---|
SQL_COPT_SS_SERVER_SPN SQL_COPT_SS_FAILOVER_PARTNER_SPN |
SQLTCHAR, zapisu i odczytu |
Określa nazwę główna nazwa usługi serwera.Wartością domyślną jest ciąg pusty, co powoduje, że SQL Server Macierzysty klient do używania domyślnej, sterownik generowane nazwy główna nazwa usługi. Ten atrybut może być kierowane kwerendy tylko wtedy, gdy został on zestaw programistycznie, lub po otwarciu połączenia.Jeśli próby kwerendy ten atrybut dla połączenia, który nie jest otwarty, a atrybut nie zostało ustawione programowo, SQL_ERROR jest zwracany, a diagnostyczne rekord jest rejestrowany z SQLState 08003 i komunikat "Nie jest otwarte połączenie". Jeśli próby atrybut podczas połączenie zostanie otwarte, zwracana jest SQL_ERROR i diagnostyczne rekord jest rejestrowany z SQLState HY011 i wiadomości „ operacja jest nieprawidłowa w tej chwili czas ". |
SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD |
SQLTCHAR, tylko do odczytu |
Zwraca metoda uwierzytelnianie używaną dla połączenia.Wartość zwracana do aplikacji jest to wartość, która zwraca systemu Windows SQL Server Macierzysta klient. Możliwe wartości to:
Ten atrybut mogą być odczytywane tylko otwarte połączenie, które jest używane uwierzytelnianie systemu Windows.Jeśli podjęta próba ją przeczytać, zanim połączenie zostanie otwarty, zwracana jest SQL_ERROR i SQLState 08003 i komunikat "Nie jest otwarte połączenie" zostanie zarejestrowany błąd. Jeśli ten atrybut jest zapyta dla połączenia, które nie za pomocą uwierzytelnianie systemu Windows, zwracana jest SQL_ERROR i SQLState HY092 i komunikatu "identyfikator atrybutu/opcji nieprawidłowe" (SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD jest dostępna tylko dla połączeń zaufane) zostanie zarejestrowany błąd. Nie można określić metoda uwierzytelnianie, zwracana jest SQL_ERROR i SQLState HY000 i komunikat "Błąd ogólne" zostanie zarejestrowany błąd. |
SQL_COPT_SS_MUTUALLY_AUTHENTICATED |
SQLSMALLINT, tylko do odczytu |
Zwraca SQL_TRUE, jeśli serwer w połączeniu z był wzajemnie uwierzytelnione; w przeciwnym razie zwraca SQL_FALSE. Ten atrybut mogą być odczytywane tylko dla otwartego połączenia.Jeśli podjęta próba ją przeczytać, zanim połączenie zostanie otwarty, zwracana jest SQL_ERROR i SQLState 08003 i komunikat "Nie jest otwarte połączenie" zostanie zarejestrowany błąd. Jeśli ten atrybut jest kwerendy dla połączenia, które nie za pomocą uwierzytelnianie systemu Windows, zostanie zwrócona SQL_FALSE. |
Określanie nazwy SPN obsługi funkcja ODBC
Następujące funkcje ODBC obsługuje aplikacje klienckie i SPN: