SQLBrowseConnect

van toepassing op:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQLBrowseConnect gebruikt trefwoorden die kunnen worden gecategoriseerd in drie niveaus van verbindingsinformatie. Voor elk trefwoord geeft de volgende tabel aan of een lijst met geldige waarden wordt teruggegeven en of het trefwoord optioneel is.

Niveau 1

Keyword	Lijst teruggegeven?	Optional?	Description
DSN	N/A	No	Naam van de gegevensbron die door SQLDataSources wordt geretourneerd. Het DSN-keyword kan niet worden gebruikt als het DRIVER-keyword wordt gebruikt.
STUURPROGRAMMA	N/A	No	De stuurnaam van SQL Server Native Client ODBC is {SQL Server Native Client 11}. Het DRIVER-sleutelwoord kan niet worden gebruikt als het DSN-sleutelwoord wordt gebruikt.

Niveau 2

Keyword	Lijst teruggegeven?	Optional?	Description
SERVER	Ja	No	Naam van de server op het netwerk waarop de databron zich bevindt. De term "(lokaal)" kan als server worden ingevoerd, in welk geval een lokale kopie van SQL Server kan worden gebruikt, zelfs als dit een niet-netwerkversie is.
unieke identificatie	No	Ja	Gebruikerslogin-ID.
PWD	No	Ja (hangt af van de gebruiker)	Door de gebruiker opgegeven wachtwoord.
APP	No	Ja	Naam van de applicatie die SQLBrowseConnect aanroept.
WSID	No	Ja	Werkstation-ID. Meestal is dit de netwerknaam van de computer waarop de applicatie draait.

Niveau 3

Keyword	Lijst teruggegeven?	Optional?	Description
DATABASE	Ja	Ja	Naam van de SQL Server-database.
LANGUAGE	Ja	Ja	Nationale taal gebruikt door SQL Server.

SQLBrowseConnect negeert de waarden van de DATABASE en LANGUAGE trefwoorden die zijn opgeslagen in de ODBC-databrondefinities. Als de database of taal die in de verbindingsreeks aan SQLBrowseConnect is doorgegeven ongeldig is, geeft SQLBrowseConnect SQL_NEED_DATA en de niveau 3 verbindingsattributen terug.

De volgende attributen, die worden ingesteld door SQLSetConnectAttr aan te roepen, bepalen de resultaatset die door SQLBrowseConnect wordt teruggegeven.

Attribute	Description
SQL_COPT_SS_BROWSE_CONNECT	Als deze is ingesteld op SQL_MORE_INFO_YES, geeft SQLBrowseConnect een uitgebreide reeks servereigenschappen terug. Het volgende is een voorbeeld van een uitgebreide string die door SQLBrowseConnect wordt teruggegeven: `ServerName\InstanceName;Clustered:No;Version:8.00.131` In deze string scheiden puntkomma's verschillende informatie over de server. Gebruik komma's om verschillende serverinstanties te scheiden.
SQL_COPT_SS_BROWSE_SERVER	Als een servernaam wordt opgegeven, zal SQLBrowseConnect informatie teruggeven voor de gespecificeerde server. Als SQL_COPT_SS_BROWSE_SERVER op NULL is gezet, geeft SQLBrowseConnect informatie terug voor alle servers in het domein. Let op dat SQLBrowseConnect mogelijk niet tijdig van alle servers reageert vanwege netwerkproblemen. Daarom kan de lijst van teruggestuurde servers per verzoek variëren.
SQL_COPT_SS_BROWSE_CACHE_DATA	Wanneer het SQL_COPT_SS_BROWSE_CACHE_DATA-attribuut op SQL_CACHE_DATA_YES is ingesteld, kun je data in chunks ophalen wanneer de bufferlengte niet groot genoeg is om het resultaat vast te houden. Deze lengte wordt gespecificeerd in het BufferLength-argument voor SQLBrowseConnect. SQL_NEED_DATA wordt teruggegeven wanneer er meer data beschikbaar is. SQL_SUCCESS wordt teruggegeven wanneer er geen gegevens meer te verzamelen zijn. De standaard is SQL_CACHE_DATA_NO.