İstemci bağlantıları (ole db)'nda hizmet asıl adlarını (SPN)
Bu konuda, ole db özellikleri ve hizmet asıl adları (SPN) istemci uygulamaları destekleyen üye işlevleri açıklanmaktadır.istemci uygulamalarında SPN'ler hakkında daha fazla bilgi için bkz: İstemci Bağlantıları'nda hizmet asıl adı (spn) desteği.
Sağlayıcı başlatma dizesi anahtar sözcükler
Aşağıdaki sağlayıcı başlatma dize anahtar sözcükler SPN ole db uygulamaları destekler.Aşağıdaki tablo, anahtar sütunundaki değerler sağlayıcı dizesi için kullanılan IDBInitialize::Initialize.Açıklama alanına değerleri sütun başlatma dizelerini ado kullanarak bağlanırken kullanılan veya IDataInitialize::GetDataSource.
Anahtar Sözcük |
Açıklama |
Değer |
|---|---|---|
ServerSPN |
spn Sunucu |
Sunucu spn.Varsayılan değer boş bir dize, neden olduğu SQL Server Native Client için kullanılacak varsayılan sağlayıcı tarafından oluşturulan spn. |
FailoverPartnerSPN |
Yerine çalışma ortağı spn |
Yerine çalışma ortak spn.Varsayılan değer boş bir dize, neden olduğu SQL Server Native Client için kullanılacak varsayılan sağlayıcı tarafından oluşturulan spn. |
Veri kaynağı başlatma özellikleri
Aşağıdaki özellikler, DBPROPSET_SQLSERVERDBINIT özellik küme belirt SPN'ler uygulamalara izin ver
Ad |
Tür |
Kullanım |
|---|---|---|
SSPROP_INIT_SERVERSPN |
vt_bstr, okuma/yazma |
Sunucu için bir spn belirtir.Varsayılan değer boş bir dize, neden olduğu SQL Server Native Client için kullanılacak varsayılan sağlayıcı tarafından oluşturulan spn. |
SSPROP_INIT_FAILOVERPARTNERSPN |
vt_bstr, okuma/yazma |
Yerine çalışma ortak için bir spn belirtir.Varsayılan değer boş bir dize, neden olduğu SQL Server Native Client için kullanılacak varsayılan sağlayıcı tarafından oluşturulan spn. |
Veri kaynağı özellikleri
Aşağıdaki özellikler, DBPROPSET_SQLSERVERDATASOURCEINFO özellik küme izin uygulamaları keşif kimlik doğrulaması yöntem.
Ad |
Tür |
Kullanım |
|---|---|---|
SSPROP_INTEGRATEDAUTHENTICATIONMETHOD |
vt_bstr, salt okunur |
Bağlantı için kullanılan kimlik doğrulaması yöntem döndürür.Uygulamasına geri döner Windows değer değerdir SQL Server yerel istemci.Olası değerler şunlardır:
Bir bağlantı açılır ve kimlik doğrulaması yöntem belirledi, vt_empty döndürülür. Bu özellik, yalnızca bir veri kaynak hazırlarken okunabilir.Özelliği bir veri kaynak başlatıldıktan sonra okumaya çalışırsanız, IDBProperties::GetProperies db_s_errorsoccurred veya uygun şekilde db_e_errorsoccurred döndürür ve dbpropstatus_notsupported küme içinde DBPROPSET_PROPERTIESINERROR için bu özellik.Bu davranış ile ole db Çekirdek belirtimidir. |
SSPROP_MUTUALLYAUTHENICATED |
vt_bool, salt okunur |
Bağlantı sunucuları karşılıklı olarak kimliği doğrulanmış ise; üzerine yazılmasına döndürür Aksi halde, VARIANT_FALSE döndürür. Bu özellik, yalnızca bir veri kaynak hazırlarken okunabilir.Bir veri kaynak başlatıldıktan sonra özellik okuma girişimi ise IDBProperties::GetProperies db_s_errorsoccurred veya uygun şekilde db_e_errorsoccurred döndürür ve dbpropstatus_notsupported küme içinde DBPROPSET_PROPERTIESINERROR için bu özellik.ole db Çekirdek belirtimine uygun olarak bu davranıştır Bu öznitelik Windows kimlik doğrulaması kullanan bir bağlantı için sorgulanan, VARIANT_FALSE döndürülür. |
SPN'ler için ole db API desteği
Aşağıdaki tablo SPN istemci bağlantılarını destekleyen ole db üye işlevleri açıklanır:
Üye işlev |
Açıklama |
|---|---|
IDataInitialize::GetDataSource |
pwszInitializationStringyeni sözcükler içerebilir ServerSPN ve FailoverPartnerSPN. |
IDataInitialize::GetInitializationString |
SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN varsayılan olmayan değerler varsa, başlangıçta eklenecektir dize ile ppwszInitString anahtar değerleri olarak ServerSPN ve FailoverPartnerSPN.Aksi takdirde, bu anahtar sözcükler başlangıçta dahil edilmez dize. |
IDBInitialize::Initialize |
İsteyen verileri DBPROP_INIT_PROMPT ayarlayarak etkin olup olmadığını kaynak başlatma özelliklerini, ole db iletişim kutusu görüntülenecektir Login.Bu asıl sunucu ve onun yerine çalışma ortak için girilecek SPN'ler sağlar. Sağlayıcı dize DPPROP_INIT_PROVIDERSTRING, küme, yeni anahtar sözcükleri tanır ServerSPN ve FailoverPartnerSPN ve bunların değerleri varsa, başlatmak, SSPROP_INIT_SERVER_SPN ve SSPROP_INIT_FAILOVER_PARTNER_SPN. IDBProperties::SetPropertiesiçin çağrılan küme SSPROP_INIT_SERVER_SPN ve SSPROP_INIT_FAILOVER_PARTNER_SPN önce özelliklerini IDBInitialize::Initialize denir.Bu alternatif bir sağlayıcı kullanarak, dize. Birden fazla yerde bir özelliğini ayarlarsanız, program aracılığıyla ayarlama bir değer sağlayıcı ayarlamak için bir değer önceliklidir dize.Bir değer ayarlamak bir başlatma dize bir oturum açma iletişim kutusunda ayarlanan bir değer önceliklidir. Sağlayıcı birden çok kez aynı anahtar sözcüğü görünüyorsa, dize, ilk değer önceliklidir. |
IDBProperties::GetProperties |
IDBProperties::GetProperties Yeni veri kaynak başlatma özellikleri SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN ve SSPROP_AUTHENTICATIONMETHOD ve SSPROP_MUTUALLYAUTHENTICATED yeni veri kaynak özellikleri değerleri almak için çağrılabilir. |
IDBProperties::GetPropertyInfo |
IdbProperties::GetPropertyInfo Yeni veri kaynak başlatma özellikleri SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN veya SSPROP_AUTHENTICATION_METHOD ve SSPROP_MUTUALLYAUTHENTICATED yeni veri kaynak özellikleri içerir. |
IDBProperties::SetProperties |
IDBProperties::SetProperties için çağrılan küme değerleri, yeni veri kaynak başlatma özelliklerini SSPROP_INITSERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN. Bu özellikleri olabilir küme veri kaynak zaten açık olan, ancak her saat aşağıdaki hata oluşur: db_e_errorsoccurred, "ole db çok adımlı işlem hatalar oluşturdu.Varsa her ole db durum değerini denetleyin.İş yapılmadı." |