Share via


Istemci bağlantıları (odbc)'nda hizmet asıl adı (SPN)

odbc özellikleri ve hizmet asıl adlarını (SPN) istemci uygulamaları destekleyen işlevleri açıklanmıştır. İstemci uygulamalarında SPN'ler hakkında daha fazla bilgi için Istemci bağlantıları'nda hizmet asıl adı (spn) desteğive Karşılıklı Kerberos kimlik doğrulaması almak.

Bağlantı dizesi anahtar sözcükler

Aşağıdaki bağlantı dizesi anahtar sözcükler spn belirtmek, istemci uygulamaları etkinleştirin.

Anahtar Sözcük

Değer

ServerSPN

Sunucu spn. Varsayılan değer olan neden boş bir dizedir SQL Servervarsayılan olarak kullanmak için istemci yerel sürücü tarafından oluşturulan spn.

FailoverPartnerSPN

Yerine çalışma ortağı spn. Varsayılan değer olan neden boş bir dizedir SQL Servervarsayılan olarak kullanmak için istemci yerel sürücü tarafından oluşturulan spn.

Bağlantı öznitelikleri

Aşağıdaki bağlantı özniteliklerini spn ve sorgu için kimlik doğrulama yöntemini belirtmek, istemci uygulamaları etkinleştirin.

Ad

Tür

Kullanım

SQL_COPT_SS_SERVER_SPN

SQL_COPT_SS_FAILOVER_PARTNER_SPN

sqltchar, okuma/yazma

spn Sunucu için belirtir. Varsayılan değer olan neden boş bir dizedir SQL Servervarsayılan olarak kullanmak için istemci yerel sürücü tarafından oluşturulan spn.

Bu özellik, yalnızca programlı olarak ayarlandıktan sonra ya da bir bağlantı açıldıktan sonra sorgulanabilir. Açık olmayan bağlantı bu özniteliği sorgulamak için bir girişimde ve öznitelik programlı olarak ayarlanmamış, sql_error döner ve tanılama kaydı SQLState 08003 ve "Bağlantı açık değil" iletisi ile kaydedilir.

Bağlantı açık olduğunda bu özniteliği ayarlamak için bir girişimde yaptıysanız, sql_error döner ve tanılama kaydı SQLState HY011 ve "İşlem şu anda geçersiz" iletisi ile kaydedilir.

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD

sqltchar, 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".

Bu öznitelik Windows kimlik doğrulaması kullanılan açık bağlantı için sadece okunabilir. Bir bağlantı açıldıktan önce okumak için bir girişimde yaptıysanız, sql_error döner ve bir hata SQLState 08003 ve "Bağlantı açık değil" iletisi ile kaydedilir.

Bu öznitelik Windows kimlik doğrulaması Kullan olmayan bir bağlantı sorgulanan, sql_error döner ve bir hata SQLState HY092 ve "geçersiz öznitelik/seçenek belirteci" (SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD yalnızca güvenilen bağlantılar için kullanılabilir) iletisi ile kaydedilir.

Kimlik doğrulama yöntemi belirlenemiyorsa sql_error döner ve bir hata SQLState HY000 ve "Genel hata" iletisi ile kaydedilir.

SQL_COPT_SS_MUTUALLY_AUTHENTICATED

SQLSMALLINT, salt okunur

Döner sunucuya bağlantı karşılıklı kimlik doğrulaması ise; sql_true Aksi takdirde, sql_false döndürür.

Bu öznitelik için açık bağlantı yalnızca okunabilir. Bir bağlantı açıldıktan önce okumak için bir girişimde yaptıysanız, sql_error döner ve bir hata SQLState 08003 ve "Bağlantı açık değil" iletisi ile kaydedilir.

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

SPN'ler belirtme için odbc fonksiyonu desteği

İstemci uygulamaları ve SPN'ler aşağıdaki odbc işlevleri destekler:

Ayrıca bkz.

Kavramlar

SQL Server yerel istemci (ODBC)