Główne nazwy usług (SPN) w oknie połączenia klient (OLE DB)
W tym temacie opisano właściwości OLE DB i funkcji element członkowski, które są obsługiwane 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 inicjowania dostawca
Następujące kluczowych ciąg inicjalizacji dostawca obsługi nazwy SPN w OLE DB aplikacji.W poniższej tabela wartości kolumna słów kluczowych są używane do ciąg dostawca IDBInitialize::Initialize. Wartości kolumna Opis są używane w ciągach inicjowania podczas łączenia się przy użyciu obiektu ADO lub IDataInitialize::GetDataSource.
Słowo kluczowe |
Description |
Wartość |
|---|---|---|
ServerSPN |
Serwera główna nazwa usługi |
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, dostawca generowane nazwy główna nazwa usługi. |
FailoverPartnerSPN |
Partner pracy awaryjnej główna nazwa usługi |
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, dostawca generowane nazwy główna nazwa usługi. |
Właściwości inicjowania urządzenie źródłowe danych
Następujące właściwość w DBPROPSET_SQLSERVERDBINIT zestaw właściwość, który umożliwia aplikacji, aby określić nazwy SPN.
Imię i nazwisko |
Typ |
Sposób użycia |
|---|---|---|
SSPROP_INIT_SERVERSPN |
VT_BSTR, 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, dostawca generowane nazwy główna nazwa usługi. |
SSPROP_INIT_FAILOVERPARTNERSPN |
VT_BSTR, zapisu i odczytu |
Określa 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, dostawca generowane nazwy główna nazwa usługi. |
Właściwości urządzenie źródłowe danych
Następujące właściwość w DBPROPSET_SQLSERVERDATASOURCEINFO zestaw właściwość pozwalają aplikacjom wykrywanie metoda uwierzytelnianie.
Imię i nazwisko |
Typ |
Sposób użycia |
|---|---|---|
SSPROP_INTEGRATEDAUTHENTICATIONMETHOD |
VT_BSTR, 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 są następujące:
Jeśli połączenie zostanie otwarte i nie można określić metoda uwierzytelnianie, zwracany jest VT_EMPTY. Tej właściwość mogą być odczytywane tylko, gdy urządzenie źródłowe danych został zainicjowany.Podczas próby odczytu właściwość, zanim urządzenie źródłowe danych ma już zainicjowany, IDBProperties::GetProperies Zwraca DB_S_ERRORSOCCURRED lub DB_E_ERRORSOCCURRED, odpowiednio, i będzie DBPROPSTATUS_NOTSUPPORTED zestaw w DBPROPzestaw_PROPERTIESINERROR dla tej właściwość. To zachowanie jest zgodne z OLE DB podstawowe specyfikacji. |
SSPROP_MUTUALLYAUTHENICATED |
VT_BOOL tylko do odczytu |
Zwraca VARIANT_TRUE, jeśli serwery w danym połączeniu były wzajemnie uwierzytelnione; w przeciwnym razie zwraca VARIANT_FALSE. Tej właściwość mogą być odczytywane tylko, gdy urządzenie źródłowe danych został zainicjowany.Jeśli próba odczytu właściwość przed urządzenie źródłowe danych został zainicjowany, IDBProperties::GetProperies Zwraca DB_S_ERRORSOCCURRED lub DB_E_ERRORSOCCURRED, odpowiednio, a DBPROPSTATUS_NOTSUPPORTED zostanie ustawiony w DBPROPSET_PROPERTIESINERROR dla tej właściwość. To zachowanie jest zgodne z specyfikacji podstawowych baz danych OLE Jeśli ten atrybut jest kwerendy dla połączenia, które nie za pomocą uwierzytelnianie systemu Windows, zostanie zwrócona VARIANT_FALSE. |
Obsługa interfejsu API DB OLE dla nazwy SPN
W poniższej tabela opisano funkcje składowe OLE DB, obsługujących nazwy SPN w połączeniach klientów:
funkcja element członkowski |
Description |
|---|---|
IDataInitialize::GetDataSource |
pwszInitializationString może zawierać nowych słów kluczowych ServerSPN i FailoverPartnerSPN. |
IDataInitialize::GetInitializationString |
Jeśli SSPROP_INIT_SERVERSPN i SSPROP_INIT_FAILOVERPARTNERSPN wartości inne niż domyślne, te mają zostać uwzględnione w ciąg inicjującego za pośrednictwem ppwszInitString jako wartości słowo kluczowe ServerSPN i FailoverPartnerSPN. W przeciwnym wypadku te słowa kluczowe nie zostaną uwzględnione w ciąg inicjującego. |
IDBInitialize::Initialize |
Jeśli włączono monitowania przez ustawienie właściwości inicjujące DBPROP_INIT_PROMPT w źródle danych, pojawi się okno dialogowe logowania OLE DB.Dzięki temu SPN mają być wprowadzone dla serwer główny i jego partner pracy awaryjnej. Dostawca ciąg w DPPROP_INIT_PROVIDERSTRING, jeśli zestaw, będzie rozpoznawać nowych słów kluczowych ServerSPN i FailoverPartnerSPN i ich wartości, należy użyć, jeśli jest obecny, aby zainicjować SSPROP_INIT_SERVER_SPN i SSPROP_INIT_FAILOVER_PARTNER_SPN. IDBProperties::SetProperties może być wywołana z zestaw właściwości SSPROP_INIT_SERVER_SPN i SSPROP_INIT_FAILOVER_PARTNER_SPN przed IDBInitialize::Initialize nazywa się. Jest to zamiast ciąg dostawca. Jeśli właściwość jest zestaw w kilku miejscach, wartość zestaw programowo ma pierwszeństwo przed wartością zestaw w ciąg dostawca.Wartość zestaw podczas inicjowania ciąg ma pierwszeństwo przed wartością zestaw w oknie dialogowym logowania. Jeśli te same słowa kluczowego pojawia się więcej niż jeden raz w ciąg dostawca, pierwszeństwo ma wartość z pierwszego wystąpienia. |
IDBProperties::GetProperties |
IDBProperties::GetProperties może zostać wywołana w celu uzyskania wartości nowe właściwości urządzenie źródłowe danych inicjujących SSPROP_INIT_SERVERSPN i SSPROP_INIT_FAILOVERPARTNERSPN i nowych właściwości urządzenie źródłowe danych, SSPROP_AUTHENTICATIONMETHOD i SSPROP_MUTUALLYAUTHENTICATED. |
IDBProperties::GetPropertyInfo |
IdbProperties::GetPropertyInfo zostaną uwzględnione nowe właściwości urządzenie źródłowe danych inicjujących SSPROP_INIT_SERVERSPN i SSPROP_INIT_FAILOVERPARTNERSPN lub nowe właściwości urządzenie źródłowe danych, SSPROP_AUTHENTICATION_METHOD i SSPROP_MUTUALLYAUTHENTICATED. |
IDBProperties::SetProperties |
IDBProperties::SetProperties może zostać wywołany do ustawiania właściwości inicjujące SSPROP_INITSERVERSPN i SSPROP_INIT_FAILOVERPARTNERSPN wartości dla nowego urządzenie źródłowe danych. Te właściwości zestaw w dowolnym momencie, ale jeśli urządzenie źródłowe danych jest już otwarte, będą zwracane następujący komunikat o błędzie: DB_E_ERRORSOCCURRED, „ operacja kroku wielu OLE DB wygenerowała błędy.Sprawdź wszystkie wartości stanu DB OLE, jeśli są dostępne.Żadna praca została wykonana. „ |