SQLBrowseConnect

A következőkre vonatkozik:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics

Az SQLBrowseConnect olyan kulcsszavakat használ, amelyeket három kapcsolati információszintre lehet sorolni. Minden kulcsszóhoz az alábbi táblázat jelzi, hogy visszaadnak-e érvényes értékek listája, és hogy a kulcsszó opcionális-e.

1. szint

Keyword	Visszaküldött listát?	Optional?	Description
DSN	N/A	No	Az SQLDataSources által visszaadott adatforrás neve. A DSN kulcsszó nem használható, ha a DRIVER kulcsszót használják.
ILLESZTŐPROGRAM	N/A	No	Az SQL Server Native Client ODBC driver neve {SQL Server Native Client 11}. A DRIVER kulcsszó nem használható, ha a DSN kulcsszót használják.

2. szint

Keyword	Visszaküldött listát?	Optional?	Description
SZERVER	Yes	No	A szerver neve azon a hálózaton, ahol az adatforrás található. A "(helyi)" kifejezés szerverként is beírható, ebben az esetben az SQL Server helyi másolata is használható, még akkor is, ha ez nem hálózati verzió.
Egyedi azonosító	No	Yes	Felhasználói bejelentkezési azonosító.
PWD	No	Igen (felhasználótól függ)	Felhasználó által megadott jelszó.
alkalmazás	No	Yes	Az SQLBrowseConnect-et hívó alkalmazás neve.
WSID	No	Yes	Munkaállomás azonosító. Általában ez a számítógép hálózati neve, amelyen az alkalmazás fut.

3. szint

Keyword	Visszaküldött listát?	Optional?	Description
DATABASE	Yes	Yes	Az SQL Server adatbázis neve.
LANGUAGE	Yes	Yes	Nemzeti nyelv, amelyet az SQL Server használ.

Az SQLBrowseConnect figyelmen kívül hagyja az ODBC adatforrás definícióiban tárolt kulcsszavak DATABASE és LANGUAGE kulcsszavak értékeit. Ha az SQLBrowseConnect-nek átadott kapcsolati karakterlánc által megadott adatbázis vagy nyelv érvénytelen, akkor az SQLBrowseConnect SQL_NEED_DATA és a 3. szintű kapcsolati attribútumokat adja vissza.

Az alábbi attribútumok, amelyeket az SQLSetConnectAttr hívásával állítanak be, meghatározzák az SQLBrowseConnect által visszaadott eredményhalmazt.

Attribute	Description
SQL_COPT_SS_BROWSE_CONNECT	Ha SQL_MORE_INFO_YES-re van állítva, az SQLBrowseConnect egy kiterjesztett szerver tulajdonságok sorozatot ad vissza. Az alábbiakban egy példa az SQLBrowseConnect által visszaadott kiterjesztett stringre: `ServerName\InstanceName;Clustered:No;Version:8.00.131` Ebben a sorozatban a félvesszők különbözik a szerverről alkotott információkat. Vesszővel kell megkülönböztetni a szerver példányait.
SQL_COPT_SS_BROWSE_SERVER	Ha szervernév van megadva, az SQLBrowseConnect visszaadja az adott szerver adatait. Ha SQL_COPT_SS_BROWSE_SERVER nullra van állítva, az SQLBrowseConnect minden szerverről visszaadja az adatokat a domainben. Fontos megjegyezni, hogy hálózati problémák miatt az SQLBrowseConnect nem feltétlenül kap időben választ minden szervertől. Ezért a visszaküldött szerverek listája minden kérésnként változhat.
SQL_COPT_SS_BROWSE_CACHE_DATA	Ha az SQL_COPT_SS_BROWSE_CACHE_DATA attribútumot SQL_CACHE_DATA_YES-re állítják, akkor is letölthetsz adatokat chunk-okban, ha a pufferhossz nem elég nagy az eredmény tárolására. Ez a hossz a BufferLength argumentumban van megadva az SQLBrowseConnect számára. SQL_NEED_DATA akkor kerül vissza, amikor több adat áll rendelkezésre. SQL_SUCCESS akkor kerül vissza, ha nincs több adat visszanyerhető. Az alapértelmezett SQL_CACHE_DATA_NO.