Hizmet asıl adlarını (SPN) istemci bağlantıları (ole db)

  • Makale

ole db özellikleri ve hizmet asıl adlarını (SPN) istemci uygulamaları destekleyen üye işlevleri açıklanmıştır. İstemci uygulamalarında SPN'ler hakkında daha fazla bilgi için bkz: Istemci bağlantıları'nda hizmet asıl adı (spn) desteği. Bir örnek için bkz: Tümleşik Kerberos kimlik doğrulaması (ole db).

Sağlayıcı Başlatma dizesi anahtar sözcükler

Aşağıdaki sağlayıcı Başlatma dizesi anahtar sözcükler SPN ole db uygulamaları destekler. Aşağıdaki tabloda, anahtar sütunundaki değerleri sağlayıcı dizesi için kullanılır IDBInitialize::Initialize. Açıklama sütunundaki değerler başlatma dizelerini ado kullanarak bağlanırken kullanılan veya IDataInitialize::GetDataSource.

Anahtar Sözcük

Açıklama

Değer

ServerSPN

Sunucu spn

Sunucu spn. Varsayılan değer olan neden boş bir dizedir SQL Serveryerel istemci varsayılan sağlayıcı tarafından oluşturulan spn.

FailoverPartnerSPN

Yerine çalışma ortağı spn

Yerine çalışma ortağı spn. Varsayılan değer olan neden boş bir dizedir SQL Serveryerel istemci varsayılan sağlayıcı tarafından oluşturulan spn.

Veri kaynağı başlatma özellikleri

Aşağıdaki özellikleri DBPROPSET_SQLSERVERDBINITözellik kümesi izin SPN'ler belirtmek uygulamaları.

Ad

Tür

Kullanım

SSPROP_INIT_SERVERSPN

vt_bstr, okuma/yazma

spn Sunucu için belirtir. Varsayılan değer olan neden boş bir dizedir SQL Serveryerel istemci varsayılan sağlayıcı tarafından oluşturulan spn.

SSPROP_INIT_FAILOVERPARTNERSPN

vt_bstr, okuma/yazma

Yerine çalışma ortağı spn belirtir. Varsayılan değer olan neden boş bir dizedir SQL Serveryerel istemci varsayılan sağlayıcı tarafından oluşturulan spn.

Veri kaynağı özellikleri

Aşağıdaki özellikleri DBPROPSET_SQLSERVERDATASOURCEINFOözellik kümesi izin uygulamaların kimlik doğrulama yöntemini keşfedin.

Ad

Tür

Kullanım

SSPROP_INTEGRATEDAUTHENTICATIONMETHOD

vt_bstr, salt okunur

Bağlantı için kullanılan kimlik doğrulama yöntemini döndürür. Uygulama için döndürülen değeri Windows döner değerdir SQL ServerNative Client. Olası değerler şunlardır:

  • "ntlm kimlik doğrulaması kullanan bir bağlantı açıldığında hangi döndürülür ntlm".

  • "Kerberos kimlik doğrulamasını kullanarak bir bağlantı açıldığında hangi döndürülen Kerberos".

Bir bağlantı açıldıktan ve kimlik doğrulama yöntemi belirlenemez, vt_empty döndürülür.

Başlatılmış bir veri kaynağı olduğunda bu özellik yalnızca okuyabilir. Önce bir veri kaynağı başlatılmış, özelliği okumaya çalışırsanız, IDBProperties::GetProperiesdb_s_errorsoccurred veya db_e_errorsoccurred, uygun şekilde dönecektir ve dwStatus DBPROPSET_PROPERTIESINERROR bu özelliği ayarlanacaktır. Bu davranış ile ole db Çekirdek belirtimidir.

SSPROP_MUTUALLYAUTHENICATED

vt_bstr, salt okunur

Döner bağlantı sunucuları karşılıklı kimlik doğrulaması varsa; Aksi halde, VARIANT_FALSE döndürür.

Başlatılmış bir veri kaynağı olduğunda bu özellik yalnızca okuyabilir. Önce bir veri kaynağı başlatılmış, özellik okuma girişimi ise IDBProperties::GetProperiesdb_s_errorsoccurred veya db_e_errorsoccurred, uygun şekilde dönecektir ve dwStatus DBPROPSET_PROPERTIESINERROR bu özelliği ayarlanacaktır. Bu davranış ole db Çekirdek belirtimidir doğrultusunda

Bu öznitelik Windows kimlik doğrulaması Kullan olmayan bir bağlantı için sorgulanan VARIANT_FALSE döndürülür.

SPN için ole db API desteği

Aşağıdaki tabloda SPN'ler istemci bağlantıları destekleyen ole db üye işlevleri açıklanmaktadır:

Üye işlevi

Açıklama

IDataInitialize::GetDataSource

pwszInitializationStringYeni anahtar kelimeleri içeren ServerSPNve FailoverPartnerSPN.

IDataInitialize::GetInitializationString

SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN varsayılan olmayan değerler varsa, onlar Başlatma dizesi dahil edilecek ppwszInitStringanahtar değerleri olarak ServerSPNve FailoverPartnerSPN. Aksi takdirde, bu anahtar kelimeler Başlatma dizesi dahil edilmez.

IDBInitialize::Initialize

İsteyen DBPROP_INIT_PROMPT veri kaynağı başlatma özelliklerini ayarlayarak etkinleştirilmişse, ole db oturum iletişim kutusu görüntülenir. Bu, hem asıl sunucu hem de onun yerine çalışma ortağı için girilecek SPN'ler sağlar.

Sağlayıcı dize DPPROP_INIT_PROVIDERSTRING içinde eğer set, yeni anahtar-ecek tanımak ServerSPNve FailoverPartnerSPN ve bunların değerleri varsa, SSPROP_INIT_SERVER_SPNDBPROPSET_SQLSERVERDBINIT ve SSPROP_INIT_FAILOVER_PARTNER_SPNDBPROPSET_SQLSERVERDBINIT başlatmak için kullanın.

IDBProperties::SetPropertiesSSPROP_INIT_SERVER_SPNDBPROPSET_SQLSERVERDBINIT ve SSPROP_INIT_FAILOVER_PARTNER_SPNDBPROPSET_SQLSERVERDBINIT önce özelliklerini ayarlamak için çağrılabilir IDBInitialize::Initializedenir. Bu sağlayıcı dizesi kullanmanın bir alternatifidir.

Birden fazla yerde bir özelliğini ayarlarsanız, program aracılığıyla ayarlama değer sağlayıcı dizesi ayarlamak bir değer önceliklidir. Bir başlatma dizesini değere bir oturum açma iletişim kutusunda ayarlanan bir değer önceliklidir.

Sağlayıcı dizesi içinde birden aynı anahtar sözcüğü görünürse, ilkinin değer önceliklidir.

IDBProperties::GetProperties

IDBProperties::GetPropertiesYeni veri kaynağı başlatma özelliklerini SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN ve yeni veri kaynağı özelliklerini SSPROP_AUTHENTICATIONMETHOD ve SSPROP_MUTUALLYAUTHENTICATED değerleri almak için çağrılabilir.

IDBProperties::GetPropertyInfo

IdbProperties::GetPropertyInfoYeni veri kaynağı başlatma özelliklerini SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN ya da SSPROP_AUTHENTICATION_METHOD ve SSPROP_MUTUALLYAUTHENTICATED yeni veri kaynağı özelliklerini içerir.

IDBProperties::SetProperties

IDBProperties::SetPropertiesYeni veri kaynağı değerleri SSPROP_INITSERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN başlatma özelliklerini ayarlamak için çağrılabilir.

Herhangi bir zamanda bu özellikleri ayarlayabilirsiniz, ancak veri kaynağı zaten açıksa, aşağıdaki hatayı döndürdü: db_e_errorsoccurred, "çok adımlı ole db işlem oluşturulan hataları. Varsa, her ole db durum değerini denetleyin. Hiçbir çalışma yapılmadı."

Ayrıca bkz.

Kavramlar

SQL Server yerel istemci (ole db)