Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 ? | Descriptif |
|---|---|---|---|
| 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é. |
| CHAUFFEUR | N/A | Non | Microsoft?? Le nom du pilote ODBC SQL Server Native Client 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 ? | Descriptif |
|---|---|---|---|
| SERVEUR | Oui | Non | Nom du serveur sur le réseau sur lequel réside la source de données. 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 non réseau. |
| Identificateur d’utilisateur | Non | Oui | ID de connexion utilisateur. |
| PWD | Non | Oui (dépend de l’utilisateur) | Mot de passe spécifié par l’utilisateur. |
| APPLI | Non | Oui | Nom de l’application appelant SQLBrowseConnect. |
| WSID | Non | Oui | ID de station de travail. En règle générale, 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 ? | Descriptif |
|---|---|---|---|
| BASE DE DONNÉES | Oui | Oui | Nom de la base de données SQL Server. |
| LANGUE | 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, qui sont définis en appelant SQLSetConnectAttr, déterminent le jeu de résultats retourné par SQLBrowseConnect.
| Caractéristique | Descriptif |
|---|---|
| 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 :Non ; Version :8.00.131 Dans cette chaîne, les points-virgules séparent différents éléments d’informations sur le serveur. Utilisez des virgules pour séparer 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 voulu de tous les serveurs. Par conséquent, la liste des serveurs retournés peut varier pour chaque requête. |
| SQL_COPT_SS_BROWSE_CACHE_DATA | Lorsque l’attribut SQL_COPT_SS_BROWSE_CACHE_DATA est défini sur SQL_CACHE_DATA_YES, vous pouvez extraire des données en blocs lorsque la longueur de la mémoire tampon n’est pas suffisante pour contenir le résultat. Cette longueur est spécifiée dans l’argument BufferLength vers SQLBrowseConnect. SQL_NEED_DATA est retourné lorsque d’autres données sont disponibles. SQL_SUCCESS est retourné lorsqu’il n’y a plus de données à récupérer. La valeur par défaut est SQL_CACHE_DATA_NO. |
Prise en charge de SQLBrowseConnect pour la haute disponibilité, la récupération d’urgence
Pour plus d’informations sur l’utilisation de SQLBrowseConnect pour vous connecter à un cluster groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre.
Prise en charge de SQLBrowseConnect pour les noms de principaux de 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 à la méthode d’authentification utilisée pour ouvrir la connexion.
Pour plus d’informations sur les SPN, consultez Les noms de principal de service (SPN) dans les connexions clientes (ODBC).
Historique des modifications
| Mise à jour du contenu |
|---|
| SQL_COPT_SS_BROWSE_CACHE_DATA documentés. |
Voir aussi
SQLBrowseConnect, fonction
Détails de l’implémentation d’API ODBC