Hizmet asıl adı (SPN) istemci bağlantıları (OLE DB)
Bu konu, OLE DB özelliklerinin ve hizmet asıl adı (SPN) istemci uygulamaları destekleyen, üye işlevleri açıklar.Istemci uygulamalarında SPN hakkında daha fazla bilgi için bkz: Hizmet asıl adı (SPN) istemci bağlantılarını desteği.
Sağlayıcı başlatma dize 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 tabloda, anahtar sözcüğü değerleri sütun sağlayıcı dizesi için kullanılır IDBInitialize::Initialize. Açıklama sütunundaki değerler, başlatma dizelerini kullanılır, ADO kullanarak bağlanırken veya IDataInitialize::GetDataSource.
Anahtar Sözcük |
Açıklama |
Değer |
---|---|---|
ServerSPN |
SPN sunucu |
SPN sunucu.Boş bir dize neden varsayılan değerdir SQL Server Varsayılan olarak kullanmak için yerel istemci sağlayıcı SPN oluşturulmuş. |
FailoverPartnerSPN |
Yerine çalışma ortak SPN |
SPN yerine çalışma ortağı.Boş bir dize neden varsayılan değerdir SQL Server Varsayılan olarak kullanmak için yerel istemci sağlayıcı SPN oluşturulmuş. |
Veri kaynak başlatma özellikleri
Aşağıdaki özellikler, DBPROPSET_SQLSERVERDBINIT özellik küme uygulamaları SPN belirtmek.
Name |
Tür |
Kullanım |
---|---|---|
ssprop_init_serverspn |
VT_BSTR, okuma/yazma |
SPN sunucu belirtir.Boş bir dize neden varsayılan değerdir SQL Server Varsayılan olarak kullanmak için yerel istemci sağlayıcı SPN oluşturulmuş. |
ssprop_init_failoverpartnerspn |
VT_BSTR, okuma/yazma |
SPN için yerine çalışma ortağı belirtir.Boş bir dize neden varsayılan değerdir SQL Server Varsayılan olarak kullanmak için yerel istemci sağlayıcı SPN oluşturulmuş. |
Veri kaynak özellikleri
Aşağıdaki özellikler, DBPROPSET_SQLSERVERDATASOURCEINFO özellik küme uygulamaları kimlik doğrulaması yöntem bulmak.
Name |
Tür |
Kullanım |
---|---|---|
ssprop_integratedauthenticationmethod |
VT_BSTR, salt okunur |
Bağlantı için kullanılan kimlik doğrulaması yöntem olarak verir.Uygulama için döndürülen değeri döndürür Windows değerdir SQL Server Yerel istemci. Olası değerler şunlardır:
Bir bağlantı açılır ve kimlik doğrulaması yöntem belirlenemiyor, VT_EMPTY döndürülür. Bu özellik, yalnızca veri, okunabilir kaynak başlatıldı.Önce veri özellik okuma girişiminde kaynak başlatıldı, IDBProperties::GetProperies DB_S_ERRORSOCCURRED veya DB_E_ERRORSOCCURRED, uygun olarak döndürür ve DBPROPSTATUS_NOTSUPPORTED DBPROPSET_PROPERTIESINERROR bu özellik için küme. Bu davranış ile OLE DB Çekirdek belirtimidir. |
ssprop_mutuallyauthenicated |
VT_BOOL, salt okunur |
Bağlantı sunucuları, kimliği doğrulanmış; aksi takdirde, karşılıklı VARIANT_TRUE VARIANT_FALSE döndürür. Bu özellik, yalnızca veri, okunabilir kaynak başlatıldı.Önce veri özellik okuma girişimi olup olmadığını kaynak başlatıldı, IDBProperties::GetProperies DB_S_ERRORSOCCURRED veya DB_E_ERRORSOCCURRED, uygun olarak döndürür ve DBPROPSTATUS_NOTSUPPORTED DBPROPSET_PROPERTIESINERROR bu özellik için küme. OLE DB Çekirdek belirtimine uygun olarak bu bir davranıştır Bu öznitelik, Windows kimlik doğrulaması kullanan bir bağlantı için sorgulandığında, VARIANT_FALSE döndürülür. |
SPN için OLE DB API desteği
Aşağıdaki tabloda istemci bağlantılarını destekleyen SPN OLE DB üye işlevleri anlatılmaktadır:
Üye işlev |
Açıklama |
---|---|
IDataInitialize::GetDataSource |
pwszInitializationString Yeni anahtar sözcükler içerebilir ServerSPN ve FailoverPartnerSPN. |
IDataInitialize::GetInitializationString |
Varsayılan olmayan değerler varsa, SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN başlatma eklenecektir dize aracılığıyla ppwszInitString anahtar değerleri ServerSPN ve FailoverPartnerSPN. Aksi halde, bu anahtar sözcükler başlatma eklenmeyecek dize. |
IDBInitialize::Initialize |
Isteyen veride DBPROP_INIT_PROMPT ayarlayarak etkin olup olmadığını kaynak başlatma özelliklerini, OLE DB iletişim kutusunda görüntülenen oturum.Bu asıl sunucu ve onun yerine çalışma ortağı için girilecek SPN sağlar. Sağlayıcı, DPPROP_INIT_PROVIDERSTRING içinde dize küme, yeni anahtar sözcükleri tanır ServerSPN ve FailoverPartnerSPN ve değerleri, eðer varsa, SSPROP_INIT_SERVER_SPN ve SSPROP_INIT_FAILOVER_PARTNER_SPN başlatılamıyor. IDBProperties::SetProperties için çağrılabilir küme SSPROP_INIT_SERVER_SPN ve önce SSPROP_INIT_FAILOVER_PARTNER_SPN özellikleri IDBInitialize::Initialize denir. Bu sağlayıcı kullanmanın bir alternatifi, dize. Bir özelliği ise küme birden fazla yerde bir değer küme programsal olarak bir değer üzerinde önceliğe sahiptir küme sağlayıcı dizesi içinde.Bir başlatma BIR değer kümesi dize bir oturum açma iletişim kutusunda ayarlanan bir değer önceliklidir. Aynı anahtar birden fazla kez sağlayıcı dizesi içinde görünüyorsa, alınan ilk değer önceliklidir. |
IDBProperties::GetProperties |
IDBProperties::GetProperties Yeni veri kaynağı başlatma özelliklerini SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN SSPROP_AUTHENTICATIONMETHOD ve SSPROP_MUTUALLYAUTHENTICATED yeni veri kaynağı özellikleri ve değerleri almak için çağrılabilir. |
IDBProperties::GetPropertyInfo |
IdbProperties::GetPropertyInfo Yeni verileri içerecek kaynak SSPROP_INIT_SERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN, başlatma özelliklerini veya yeni veri kaynak SSPROP_AUTHENTICATION_METHOD ve SSPROP_MUTUALLYAUTHENTICATED. |
IDBProperties::SetProperties |
IDBProperties::SetProperties için çağrılabilir küme başlatma özelliklerini SSPROP_INITSERVERSPN ve SSPROP_INIT_FAILOVERPARTNERSPN değerlerin yeni veri kaynağı. Bu özellik istenildiği saat ayarlanabilir, ancak veri kaynağı zaten açıksa, aşağıdaki hatayı döndürdü: DB_E_ERRORSOCCURRED, "OLE DB çok adımlı işlem hatalar oluşturdu.Varsa, her bir OLE DB durum değerini denetleyin.Hiçbir iş yapılmadı." |