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 :
Les niveaux d’informations suivants sont valides uniquement pour NetShareSetInfo :
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.