SQLBrowseConnect

SQLBrowseConnect utilise des mots clés qui peuvent être classés en trois niveaux d'informations de connexion. Pour chaque mot clé, le tableau suivant indique si une liste de valeurs valides est retournée et si le mot clé est facultatif.

Niveau 1

Mot clé

Liste retournée ?

Facultatif ?

Description

DSN

N/A

Non

Nom de la source de données retourné par SQLDataSources. Le mot clé DSN ne peut pas être utilisé si le mot clé DRIVER est utilisé.

DRIVER

N/A

Non

Le nom du pilote ODBC Microsoft® SQL Server Native Client est {SQL Server Native Client 10}. Le mot clé DRIVER ne peut pas être utilisé si le mot clé DSN est utilisé.

Niveau 2

Mot clé

Liste retournée ?

Facultatif ?

Description

SERVER

Oui

Non

Nom du serveur sur le réseau sur lequel la source de données réside. Le terme « local » peut être entré en tant que serveur, auquel cas une copie locale de SQL Server peut être utilisée, même lorsqu'il s'agit d'une version hors réseau.

UID

Non

Oui

ID de connexion d'utilisateur.

PWD

Non

Oui (dépend de l'utilisateur)

Mot de passe spécifié par l'utilisateur.

APP

Non

Oui

Nom de l'application qui appelle SQLBrowseConnect.

WSID

Non

Oui

ID de station de travail. En général, il s'agit du nom réseau de l'ordinateur sur lequel l'application s'exécute.

Niveau 3

Mot clé

Liste retournée ?

Facultatif ?

Description

DATABASE

Oui

Oui

Nom de la base de données SQL Server.

LANGUAGE

Oui

Oui

Langage national utilisé par SQL Server.

SQLBrowseConnect ignore les valeurs des mots clés DATABASE et LANGUAGE stockés dans les définitions de source de données ODBC. Si la base de données ou le langage spécifié dans la chaîne de connexion passée à SQLBrowseConnect n'est pas valide, SQLBrowseConnect retourne SQL_NEED_DATA et les attributs de connexion de niveau 3.

Les attributs suivants, définis en appelant SQLSetConnectAttr, déterminent le jeu de résultats retourné par SQLBrowseConnect.

Attribut

Description

SQL_COPT_SS_BROWSE_CONNECT

S'il a la valeur SQL_MORE_INFO_YES, dans SQL Server 2000 et versions ultérieures, SQLBrowseConnect retourne une chaîne étendue de propriétés du serveur.

Voici un exemple de chaîne étendue retournée par SQLBrowseConnect dans SQL Server 2000 :

ServerName\InstanceName;Clustered:No;Version:8.00.131

Dans cette chaîne, des points-virgules séparent les différentes parties des informations sur le serveur. Utilisez des virgules pour séparer les différentes instances de serveur.

SQL_COPT_SS_BROWSE_SERVER

Si un nom de serveur est spécifié, SQLBrowseConnect retournera des informations pour le serveur spécifié. Si SQL_COPT_SS_BROWSE_SERVER a la valeur NULL, SQLBrowseConnect retourne des informations pour tous les serveurs dans le domaine.

RemarqueRemarque
En raison de problèmes réseau, SQLBrowseConnect risque de ne pas recevoir de réponse de tous les serveurs dans les délais impartis. Par conséquent, la liste des serveurs retournée peut varier pour chaque requête.

SQL_COPT_SS_BROWSE_CACHE_DATA

Lorsque l'attribut SQL_COPT_SS_BROWSE_CACHE_DATA a la valeur SQL_CACHE_DATA_YES, vous pouvez extraire les données en plusieurs segments lorsque la longueur de la mémoire tampon est insuffisante pour contenir le résultat. Cette longueur est spécifiée dans l'argument BufferLength pour SQLBrowseConnect.

La valeur SQL_NEED_DATA est retournée lorsque davantage de données sont disponibles. La valeur SQL_SUCCESS est retournée lorsqu'il n'existe plus de données à récupérer.

La valeur par défaut est SQL_CACHE_DATA_NO.

Prise en charge par SQLBrowseConnect des noms de principaux du service (SPN)

Lors de l'ouverture d'une connexion, SQL Server Native Client définit SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD sur la méthode d'authentification employée pour ouvrir la connexion.

Pour plus d'informations sur les noms de principaux de service (SPN), consultez Noms principaux de service (SPN) dans les connexions clientes (ODBC).