SHARE_INFO_502 structure (lmshare.h)

Article
03/01/2024

Contient des informations sur la ressource partagée, notamment le nom de la ressource, le type et les autorisations, le nombre de connexions et d’autres informations pertinentes.

Syntaxe

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Membres

shi502_netname

Pointeur vers une chaîne Unicode spécifiant le nom d’une ressource partagée. Les appels à la fonction NetShareSetInfo ignorent ce membre.

shi502_type

Combinaison de valeurs qui spécifient le type de partage. Les appels à la fonction NetShareSetInfo ignorent ce membre.

L’une des valeurs suivantes peut être spécifiée. Vous pouvez isoler ces valeurs à l’aide de la valeur STYPE_MASK .

Valeur	Signification
STYPE_DISKTREE	Disque.
STYPE_PRINTQ	File d’attente d’impression.
STYPE_DEVICE	Appareil de communication.
STYPE_IPC	Communication interprocessus (IPC).

En outre, une ou les deux valeurs suivantes peuvent être spécifiées.

Valeur	Signification
STYPE_SPECIAL	Partage spécial réservé à la communication interprocessus (IPC$) ou à l’administration à distance du serveur (ADMIN$). Peut également faire référence à des partages administratifs tels que C$, D$, E$, etc. Pour plus d’informations, consultez les fonctions de partage réseau.
STYPE_TEMPORARY	Partage temporaire.

shi502_remark

Pointeur vers une chaîne Unicode spécifiant un commentaire facultatif sur la ressource partagée.

shi502_permissions

Spécifie une valeur DWORD qui indique les autorisations de la ressource partagée pour les serveurs s’exécutant avec une sécurité au niveau du partage. Ce membre est ignoré sur un serveur exécutant la sécurité au niveau de l’utilisateur. Ce membre peut être l’une des valeurs suivantes. Les appels à la fonction NetShareSetInfo ignorent ce membre.

Notez que Windows ne prend pas en charge la sécurité au niveau du partage. Pour plus d’informations sur le contrôle de l’accès aux objets sécurisables, consultez Access Control, Privilèges et Objets sécurisables.

Valeur	Signification
ACCESS_READ	Autorisation de lire les données d’une ressource et, par défaut, d’exécuter la ressource.
ACCESS_WRITE	Autorisation d’écrire des données dans la ressource.
ACCESS_CREATE	Autorisation de créer un instance de la ressource (par exemple, un fichier) ; les données peuvent être écrites dans la ressource au fur et à mesure de la création de la ressource.
ACCESS_EXEC	Autorisation d’exécuter la ressource.
ACCESS_DELETE	Autorisation de supprimer la ressource.
ACCESS_ATRIB	Autorisation de modifier les attributs de la ressource (par exemple, la date et l’heure de la dernière modification d’un fichier).
ACCESS_PERM	Autorisation de modifier les autorisations (lecture, écriture, création, exécution et suppression) attribuées à une ressource pour un utilisateur ou une application.
ACCESS_ALL	Autorisation de lire, d’écrire, de créer, d’exécuter et de supprimer des ressources, et de modifier leurs attributs et autorisations.

shi502_max_uses

Spécifie une valeur DWORD qui indique le nombre maximal de connexions simultanées que la ressource partagée peut prendre en charge. Le nombre de connexions est illimité si la valeur spécifiée dans ce membre est –1.

shi502_current_uses

Spécifie une valeur DWORD qui indique le nombre de connexions actuelles à la ressource. Les appels à la fonction NetShareSetInfo ignorent ce membre.

shi502_path

Pointeur vers une chaîne Unicode qui contient le chemin d’accès local de la ressource partagée. Pour les disques, ce membre est le chemin d’accès partagé. Pour les files d’attente d’impression, ce membre est le nom de la file d’attente d’impression partagée. Les appels à la fonction NetShareSetInfo ignorent ce membre.

shi502_passwd

Pointeur vers une chaîne Unicode qui spécifie le mot de passe du partage (lorsque le serveur s’exécute avec la sécurité au niveau du partage). Si le serveur s’exécute avec une sécurité au niveau de l’utilisateur, ce membre est ignoré. Notez que Windows ne prend pas en charge la sécurité au niveau du partage.

Ce membre ne peut pas dépasser SHPWLEN+1 octets (y compris un caractère null de fin). Les appels à la fonction NetShareSetInfo ignorent ce membre.

shi502_reserved

Réservés au; doit être égal à zéro. Les appels à la fonction NetShareSetInfo ignorent ce membre.

shi502_security_descriptor

Spécifie le SECURITY_DESCRIPTOR associé à ce partage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	lmshare.h (include Lm.h)

Voir aussi

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Fonctions de partage réseau