Partager via


Partager des fonctions

Les fonctions de partage de gestion réseau contrôlent les ressources partagées. Une ressource partagée est une ressource locale sur un serveur (par exemple, un répertoire de disque, un périphérique d’impression ou un canal nommé) accessible par les utilisateurs et les applications sur le réseau.

Les fonctions de partage sont répertoriées ci-dessous.

Fonction Description
NetShareAdd Partage une ressource sur un serveur.
netShareCheck Interroge si un serveur partage un appareil.
NetShareDel Supprime un nom de partage de la liste des ressources partagées d’un serveur.
netShareEnum Récupère des informations de partage sur chaque ressource partagée sur un serveur.
netShareGetInfo Récupère des informations sur une ressource partagée spécifiée sur un serveur.
netShareSetInfo Définit les paramètres d’une ressource partagée.

 

Ces fonctions de partage s’appliquent uniquement aux partages sur un serveur de bloc de messages serveur (GESTIONNAIRE LAN). Ces fonctions de partage ne prennent pas en charge les partages DFS (Distributed File System). Par exemple, la fonction NetShareGetInfo ne peut récupérer des informations que pour une ressource de partage spécifiée sur un serveur SMB. Pour récupérer des informations pour un partage à l’aide d’un autre fournisseur réseau (WebDAV ou d’un partage DFS, par exemple), utilisez la fonction WNetGetConnection.

La fonction NetShareAdd permet à un utilisateur ou à une application de partager une ressource d’un type spécifique à l’aide du nom de partage spécifié. La fonction NetShareAdd nécessite le nom du partage et le nom de l’appareil local pour partager la ressource. Un utilisateur ou une application doit avoir un compte sur le serveur pour accéder à la ressource.

Vous pouvez également spécifier un descripteur de sécurité à associer à un partage. Les descripteurs de sécurité spécifient quels utilisateurs sont autorisés à accéder aux fichiers via le partage et avec le type d’accès. Spécifiez un SECURITY_DESCRIPTOR avec le niveau d’informations SHARE_INFO_502 lors de l’appel NetShareAdd ou NetShareSetInfo. NetShareSetInfo prend en charge le niveau d’informations SHARE_INFO_1501. Pour plus d’informations sur les descripteurs de sécurité, consultez Access Control.

Les fonctions de gestion réseau utilisent les noms de partage spéciaux suivants pour la communication interprocesseur (IPC) et l’administration à distance du serveur :

  • IPC$, réservé pour la communication interprocesseur
  • ADMIN$, réservé pour l’administration à distance
  • A$, B$, C$ (et d’autres noms de disques locaux suivis d’un signe dollar), attribués aux appareils de disque local

Pour répertorier toutes les connexions effectuées à une ressource partagée sur un serveur ou pour répertorier toutes les connexions établies à partir d’un ordinateur particulier, appelez la fonction NetConnectionEnum. Vous pouvez appeler NetConnectionEnum aux niveaux d’informations CONNECTION_INFO_0 et CONNECTION_INFO_1.

Les fonctions de partage sont disponibles aux niveaux d’informations suivants, bien que certains niveaux de partage ne s’appliquent qu’à certaines fonctions de partage :

Pour plus d’informations, consultez la documentation relative à une fonction de partage spécifique.

Si vous programmez Pour Active Directory, vous pouvez appeler certaines méthodes ADSI (Active Directory Service Interface) pour obtenir les mêmes fonctionnalités que celles que vous pouvez obtenir en appelant les fonctions de partage de gestion réseau. Pour plus d’informations, consultez IADsFileShare .