SQLBrowseConnect

gäller för:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQLBrowseConnect använder nyckelord som kan kategoriseras i tre nivåer av anslutningsinformation. För varje nyckelord visar följande tabell om en lista med giltiga värden returneras och om nyckelordet är valfritt.

Nivå 1

Keyword	Listan returnerad?	Optional?	Description
DSN	N/A	No	Namnet på datakällan som returneras av SQLDataSources. DSN-nyckelordet kan inte användas om DRIVER-nyckelordet används.
DRIVER	N/A	No	SQL Server Native Client ODBC-drivrutinsnamnet är {SQL Server Native Client 11}. DRIVER-nyckelordet kan inte användas om DSN-nyckelordet används.

Nivå 2

Keyword	Listan returnerad?	Optional?	Description
SERVER	Yes	No	Namnet på servern på nätverket där datakällan finns. Termen "(lokal)" kan anges som server, i vilket fall en lokal kopia av SQL Server kan användas, även om detta är en icke-nätverksansluten version.
Unik identifierare (UID)	No	Yes	Användarinloggnings-ID.
PWD	No	Ja (beror på användaren)	Användarangiven lösenord.
APP	No	Yes	Namnet på applikationen som anropar SQLBrowseConnect.
WSID	No	Yes	Arbetsstations-ID. Vanligtvis är detta nätverksnamnet på datorn där applikationen körs.

Nivå 3

Keyword	Listan returnerad?	Optional?	Description
DATABASE	Yes	Yes	Namnet på SQL Server-databasen.
LANGUAGE	Yes	Yes	Det nationella språket används av SQL Server.

SQLBrowseConnect ignorerar värdena för och DATABASELANGUAGE nyckelorden som lagras i ODBC:s datakälldefinitioner. Om databasen eller språket som anges i reťazec pripojenia som skickas till SQLBrowseConnect är ogiltigt, returnerar SQLBrowseConnect SQL_NEED_DATA och nivå 3-anslutningsattributen.

Följande attribut, som sätts genom att anropa SQLSetConnectAttr, bestämmer resultatmängden som returneras av SQLBrowseConnect.

Attribute	Description
SQL_COPT_SS_BROWSE_CONNECT	Om den är inställd på SQL_MORE_INFO_YES returnerar SQLBrowseConnect en utökad sträng av serveregenskaper. Följande är ett exempel på en utökad sträng som returneras av SQLBrowseConnect: `ServerName\InstanceName;Clustered:No;Version:8.00.131` I denna sträng separerar semikolon olika informationsbitar om servern. Använd kommatecken för att separera olika serverinstanser.
SQL_COPT_SS_BROWSE_SERVER	Om ett servernamn anges kommer SQLBrowseConnect att returnera information för den angivna servern. Om SQL_COPT_SS_BROWSE_SERVER är satt till NULL returnerar SQLBrowseConnect information för alla servrar i domänen. Observera att på grund av nätverksproblem kan SQLBrowseConnect inte få ett snabbt svar från alla servrar. Därför kan listan över servrar som returneras variera för varje förfrågan.
SQL_COPT_SS_BROWSE_CACHE_DATA	När attributet SQL_COPT_SS_BROWSE_CACHE_DATA är inställt på SQL_CACHE_DATA_YES kan du hämta data i bitar när buffertlängden inte är tillräckligt stor för att hålla resultatet. Denna längd specificeras i argumentet BufferLength till SQLBrowseConnect. SQL_NEED_DATA returneras när mer data finns tillgänglig. SQL_SUCCESS returneras när det inte finns mer data att hämta. Standarden är SQL_CACHE_DATA_NO.