Share via


Fonctions de partage réseau

Les fonctions de partage 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.

 

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 quel type d’accès. Spécifiez un SECURITY_DESCRIPTOR avec le niveau d’informations SHARE_INFO_502 lors de l’appel de 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 interprocess (IPC) et l’administration à distance du serveur :

  • IPC$, réservé à la communication interprocessus
  • ADMIN$, réservé à l’administration à distance
  • A$, B$, C$ (et d’autres noms de disque locaux suivis d’un signe dollar), attribués aux périphériques de disque locaux

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 :

SHARE_INFO_0
SHARE_INFO_1
SHARE_INFO_2
SHARE_INFO_501
SHARE_INFO_502
SHARE_INFO_1005

Les niveaux d’informations suivants sont valides uniquement pour NetShareSetInfo :

SHARE_INFO_1004
SHARE_INFO_1006
SHARE_INFO_1501

Si vous programmez pour Active Directory, vous pouvez peut-être 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.