SQLBrowseConnect

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLBrowseConnect , bağlantı bilgisinin üç seviyesine ayrılabilen anahtar kelimeler kullanır. Her anahtar kelime için, aşağıdaki tablo geçerli değerler listesinin döndürülüp dönmediğini ve anahtar kelimenin isteğe bağlı olup olmadığını gösterir.

Düzey 1

Keyword Liste geri mi geldi? Optional? Description
DSN N/A Hayır SQLDataSources tarafından döndürülen veri kaynağının adı. DSN anahtar kelimesi, DRIVER anahtar kelimesi kullanılıyorsa kullanılamaz.
SÜRÜCÜ N/A Hayır SQL Server Native Client ODBC sürücü adı {SQL Server Native Client 11}'dir. DSN anahtar kelimesi kullanılıyorsa DRIVER anahtar kelimesi kullanılamaz.

Düzey 2

Keyword Liste geri mi geldi? Optional? Description
SUNUCU Yes Hayır Veri kaynağının bulunduğu ağdaki sunucunun adı. "(Yerel)" terimi sunucu olarak girilebilir; bu durumda ağ bağlantısı olmayan bir versiyon olsa bile yerel SQL Server kopyası kullanılabilir.
Kullanıcı Kimliği Hayır Yes Kullanıcı giriş kimliği.
PWD Hayır Evet (kullanıcıya bağlı) Kullanıcı tarafından belirtilen şifre.
uygulama Hayır Yes SQLBrowseConnect çağıran uygulamanın adı.
WSID Hayır Yes İş istasyonu kimliği. Genellikle, bu uygulamanın çalıştığı bilgisayarın ağ adıdır.

Düzey 3

Keyword Liste geri mi geldi? Optional? Description
DATABASE Yes Yes SQL Server veritabanının adı.
LANGUAGE Yes Yes SQL Server tarafından kullanılan ulusal dil.

SQLBrowseConnect , ODBC veri kaynağı tanımlarında saklanan anahtar DATABASE kelimeler ve LANGUAGE değerleri görmezden gelir. SQLBrowseConnect'e iletilen bağlantı dizesi veritabanı veya dil geçersizse, SQLBrowseConnect SQL_NEED_DATA ve seviye 3 bağlantı özelliklerini döndürür.

SQLSetConnectAttr çağrılarak belirlenen aşağıdaki öznitelikler, SQLBrowseConnect tarafından duygulanan sonuç kümesini belirler.

Attribute Description
SQL_COPT_SS_BROWSE_CONNECT Eğer SQL_MORE_INFO_YES olarak ayarlanmışsa, SQLBrowseConnect genişletilmiş bir sunucu özellikleri dizisi döner.

Aşağıda, SQLBrowseConnect tarafından geri getirilen genişletilmiş bir dizeye örnek verilmiştir:



ServerName\InstanceName;Clustered:No;Version:8.00.131



Bu dizide, nokta virgül ile sunucu hakkında çeşitli bilgileri ayırır. Farklı sunucu örneklerini vedelemek için virgül kullanın.
SQL_COPT_SS_BROWSE_SERVER Bir sunucu adı belirtilmişse, SQLBrowseConnect belirtilen sunucu için bilgi döndürecektir. Eğer SQL_COPT_SS_BROWSE_SERVER NULL olarak ayarlanmışsa, SQLBrowseConnect alan içindeki tüm sunucular için bilgi döndürür.



Ağ sorunları nedeniyle SQLBrowseConnect tüm sunuculardan zamanında yanıt alamayabilir. Bu nedenle, her istek için geri gönderilen sunucu listesi değişiklik gösterebilir.
SQL_COPT_SS_BROWSE_CACHE_DATA SQL_COPT_SS_BROWSE_CACHE_DATA özniteliği SQL_CACHE_DATA_YES olarak ayarlandığında, tampon uzunluğu sonucu tutacak kadar büyük olmadığında verileri parçalar halinde getirebilirsiniz. Bu uzunluk, BufferLength argümanında SQLBrowseConnect'e belirtilmiştir.

SQL_NEED_DATA daha fazla veri bulunduğunda geri dönülür. SQL_SUCCESS geri alınacak başka veri kalmadığında geri dönülür.

Varsayılan SQL_CACHE_DATA_NO.

Yüksek Erişilebilirlik, Felaket Kurtarma için SQLBrowseConnect Desteği

Always Açık erişilebilirlik grupları kümesine bağlanmak için SQLBrowseConnect kullanımı hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery sayfasına bakınız.

SQLBrowseConnect Hizmet Başlıca Adları (SPN) için Destek

Bir bağlantı açıldığında, SQL Server Native Client SQL_COPT_SS_MUTUALLY_AUTHENTICATED ve bağlantıyı açmak için kullanılan kimlik doğrulama yöntemine SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ayarlar.

SPN'ler hakkında daha fazla bilgi için Client Connections (ODBC) içindeki Hizmet Başlıca Adları (SPN) bölümüne bakınız.

Değişiklik Geçmişi

Güncelleştirilmiş içerik
Belgelenmiş SQL_COPT_SS_BROWSE_CACHE_DATA.

Ayrıca Bkz.

SQLBrowseConnect Fonksiyonu
ODBC API Uygulama Ayrıntıları