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ée par SQLDataSources. Le mot clé DSN ne peut pas être utilisé si le mot clé DRIVER est utilisé. |
DRIVER | N/A | Non | Microsoft?? SQL Server Native Client nom du pilote ODBC est {SQL Server Native Client 11}. 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 s’il s’agit d’une version non réseau. |
Identificateur d’utilisateur | 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 appelant 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 | Langue nationale utilisée par SQL Server. |
SQLBrowseConnect ignore les valeurs des mots clés DATABASE et LANGUAGE stockées dans les définitions de source de données ODBC. Si la base de données ou la langue spécifiée 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, qui sont définis en appelant SQLSetConnectAttr, déterminent le jeu de résultats retourné par SQLBrowseConnect.
Attribut | Description |
---|---|
SQL_COPT_SS_BROWSE_CONNECT | S’il est défini sur SQL_MORE_INFO_YES, SQLBrowseConnect retourne une chaîne étendue de propriétés de serveur. Voici un exemple de chaîne étendue retournée par SQLBrowseConnect: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 retourne 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 du domaine. En raison de problèmes réseau, SQLBrowseConnect peut ne pas recevoir de réponse en temps opportun de tous les serveurs. 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 sur 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 fonctionnalités de récupération d'urgence, haute disponibilité
Pour plus d’informations sur l’utilisation de SQLBrowseConnect pour se connecter à un cluster de groupes de disponibilité Always On, consultez SQL Server Native Client prise en charge de la haute disponibilité et de la récupération d’urgence.
Prise en charge par SQLBrowseConnect des noms de principaux du service (SPN)
Lorsqu’une connexion est ouverte, SQL Server Native Client définit SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD sur la méthode d’authentification utilisée pour ouvrir la connexion.
Pour plus d’informations sur les SPN, consultez Noms de principaux de service (SPN) dans les connexions clientes (ODBC).
Historique des modifications
Mise à jour du contenu |
---|
SQL_COPT_SS_BROWSE_CACHE_DATA documenté. |
Voir aussi
Fonction SQLBrowseConnect
Détails de l’implémentation d’API ODBC