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 Server Message Block (GESTIONNAIRE LAN). Ces fonctions de partage ne prennent pas en charge les partages de système de fichiers distribués (DFS). Par exemple, la fonction NetShareGetInfo peut uniquement récupérer des informations 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 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 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 interprocessus (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 disques locaux suivis d’un signe dollar), attribués aux périphériques de disque local
Pour répertorier toutes les connexions établies à 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 CONNECTION_INFO_0 et CONNECTION_INFO_1 informations.
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 :
- SHARE_INFO_0
- SHARE_INFO_1
- SHARE_INFO_2
- SHARE_INFO_501
- SHARE_INFO_502
- SHARE_INFO_503
- SHARE_INFO_1004
- SHARE_INFO_1005
- SHARE_INFO_1006
- SHARE_INFO_1501
Pour plus d’informations, consultez la documentation relative à une fonction de partage spécifique.
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.