SQLManageDataSources

Conformité
Version introduite : ODBC 2.0

Résumé
SQLManageDataSources affiche une boîte de dialogue avec laquelle les utilisateurs peuvent configurer, ajouter et supprimer des sources de données dans les informations système.

Syntaxe

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Arguments

Hwnd
[Entrée] Poignée de fenêtre parente.

Retours

SQLManageDataSources retourne FALSE si hwnd n’est pas un handle de fenêtre valide. Sinon, elle retourne TRUE.

Diagnostics

Lorsque SQLManageDataSources retourne FALSE, une valeur *pfErrorCode associée peut être obtenue en appelant SQLInstallerError. Le tableau suivant répertorie les valeurs *pfErrorCode qui peuvent être retournées par SQLInstallerError et explique chacune d’elles dans le contexte de cette fonction.

Gestion des sources de données

SQLManageDataSources affiche initialement la boîte de dialogue Administrateur de source de données ODBC , comme illustré dans l’illustration suivante.

Boîte

La boîte de dialogue affiche les sources de données répertoriées dans les informations système sous trois onglets : DSN utilisateur, DSN système et DSN fichier. Si l’utilisateur double-clique sur une source de données ou sélectionne une source de données et clique sur Configurer, SQLManageDataSources appelle ConfigDSN dans la DLL d’installation avec l’option ODBC_CONFIG_DSN.

Si l’utilisateur clique sur Ajouter, SQLManageDataSources affiche la boîte de dialogue Créer une source de données , illustrée dans l’illustration suivante.

La boîte de dialogue affiche une liste des pilotes installés. Si l’utilisateur double-clique sur un pilote ou sélectionne un pilote et clique sur OK, SQLManageDataSources appelle ConfigDSN dans la DLL d’installation et lui transmet l’option ODBC_ADD_DSN.

Si l’utilisateur sélectionne une source de données et clique sur Supprimer, SQLManageDataSources demande si l’utilisateur souhaite supprimer la source de données. Si l’utilisateur clique sur Oui, SQLManageDataSources appelle ConfigDSN dans la DLL d’installation avec l’option ODBC_REMOVE_DSN.

La boîte de dialogue Créer une source de données permet d’ajouter ou de supprimer une source de données utilisateur, une source de données système ou une source de données de fichier.

DSN utilisateur

Les noms de source de données créés pour des utilisateurs individuels seront appelés DSN utilisateur, pour les distinguer des noms de domaine système. Les noms de source de données utilisateur sont inscrits comme suit dans les informations système :

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

DSN système

La boîte de dialogue Créer une source de données vous permet d’ajouter une source de données système à votre ordinateur local ou d’en supprimer une, ou de définir la configuration d’une source de données système.

Une source de données configurée avec un nom de source de données système (DSN) peut être utilisée par plusieurs utilisateurs sur le même ordinateur. Il peut également être utilisé par un service à l’échelle du système, qui peut ensuite accéder à la source de données même si aucun utilisateur n’est connecté à la machine.

Un DSN système est inscrit dans l’entrée HKEY_LOCAL_MACHINE dans les informations système plutôt que dans l’entrée HKEY_CURRENT_USER. Il n’est pas lié à un utilisateur qui se connecte avec son nom d’utilisateur et son mot de passe particuliers, mais peut être utilisé par n’importe quel utilisateur de cet ordinateur ou par un service automatique à l’échelle du système. Toutefois, le DSN système est lié à une seule machine. Il ne prend pas en charge la possibilité d’utiliser des DSN distants entre des machines. Les DSN système sont inscrits comme suit dans les informations système :

Odbc.ini ODBC HKEY_LOCAL_MACHINE SOFTWARE

DSN de fichier

Une source de données de fichier n’a pas de nom de source de données, comme une source de données de machine, et n’est inscrite auprès d’aucun utilisateur ou ordinateur. Les informations de connexion de cette source de données sont contenues dans un fichier .dsn qui peut être copié sur n’importe quel ordinateur. Une source de données de fichier peut être partageable, auquel cas le fichier .dsn réside sur un réseau et peut être utilisé simultanément par plusieurs utilisateurs sur le réseau tant que l’utilisateur dispose du pilote approprié installé. Une source de données de fichier peut également être non partageable, auquel cas elle ne peut être utilisée que sur une seule machine.

Pour plus d’informations sur les sources de données de fichier, consultez Connexion à l’aide de sources de données de fichier ou SQLDriverConnect.

Gestion des pilotes

Si l’utilisateur clique sur l’onglet Pilotes dans la boîte de dialogue Administrateur de source de données ODBC , SQLManageDataSources affiche une liste des pilotes ODBC installés sur le système, ainsi que des informations sur les pilotes. La date affichée est la date de création du pilote, comme illustré dans l’illustration suivante.

Options de suivi

Si l’utilisateur clique sur l’onglet Suivi dans la boîte de dialogue Administrateur de source de données ODBC , SQLManageDataSources affiche les options de suivi, comme illustré dans l’illustration suivante.

Si l’utilisateur clique sur Démarrer le suivi maintenant , puis sur OK, SQLManageDataSources active le suivi manuellement pour toutes les applications en cours d’exécution sur l’ordinateur.

Si l’utilisateur spécifie le nom d’un fichier de trace dans la zone de texte Chemin du fichier journal, puis clique sur OK, SQLManageDataSources définit le mot clé TraceFile dans la section [ODBC] des informations système sur le nom spécifié.

Si l’utilisateur clique sur Démarrer Visual Studio Analyzer , puis sur OK, Visual Studio Analyzer est activé. Il reste activé jusqu’à ce que l’utilisateur clique sur Arrêter Visual Studio Analyzer .

Pour plus d’informations sur le suivi, consultez Traçage. Pour plus d’informations sur les mots clés Trace et TraceFile , consultez Sous-clé ODBC.

Fonctions connexes