Utiliser des fonctions
Les fonctions d’utilisation de gestion réseau examinent et gèrent les connexions (utilisations) entre les stations de travail et les serveurs. Les fonctions d’utilisation sont répertoriées ci-dessous.
| Fonction | Description |
|---|---|
| NetUseAdd | Crée une connexion entre un ordinateur local et un serveur. |
| NetUseDel | Met fin à une connexion à une ressource partagée. |
| NetUseEnum | Répertorie toutes les connexions actuelles entre l’ordinateur local et les ressources sur les serveurs distants. |
| NetUseGetInfo | Retourne des informations sur une connexion à une ressource partagée. |
Cette fonction s’applique uniquement au client Server Message Block (LAN Manager Workstation). La fonction NetUseGetInfo ne prend pas en charge les partages DFS (Distributed File System). Pour récupérer les informations de connexion d’une ressource partagée à l’aide d’un autre fournisseur réseau (WebDAV ou un partage DFS, par exemple), utilisez la fonction WNetGetConnection .
Les connexions se distinguent des sessions : une session est établie la première fois qu’une station de travail établit une connexion à une ressource partagée sur le serveur. Toutes les connexions supplémentaires entre la station de travail et le serveur font partie de cette même session jusqu’à la fin de la session. Il est possible d’établir deux types de connexions : les connexions de nom d’appareil (qui ne peuvent être explicites que) et les connexions de convention de nommage universel (UNC) (qui peuvent être explicites ou implicites).
Les connexions sont établies par utilisateur. Une connexion établie par un utilisateur est supprimée lorsque cet utilisateur se déconnecte. Pour cette raison, les fonctions d’utilisation de gestion réseau sont uniquement locales, car une connexion configurée par un utilisateur distant ne serait accessible à aucun autre utilisateur, même l’utilisateur connecté de manière interactive à cet ordinateur.
La fonction NetUseAdd établit une connexion explicite entre l’ordinateur local et une ressource partagée sur un serveur en redirigeant un nom d’appareil local vers le nom de partage d’une ressource de serveur distant (\\servername\sharename). Une fois qu’une connexion de nom d’appareil est établie, les utilisateurs ou les applications peuvent utiliser la ressource distante en spécifiant le nom de l’appareil local.
Les connexions UNC implicites sont effectuées par la fonction responsable de la connexion. Pour établir une connexion UNC implicite, une application transmet le nom de partage d’une ressource à n’importe quelle fonction qui accepte les chemins UNC. La fonction accepte le nom UNC et établit une connexion au nom de partage spécifié. Toutes les autres demandes sur cette connexion nécessitent le nom complet du partage.
Les fonctions d’utilisation sont disponibles aux niveaux d’informations suivants :