SHARE_INFO_2 structure (lmshare.h)

Article
08/24/2023

Contient des informations sur la ressource partagée, notamment le nom de la ressource, le type et les autorisations, ainsi que le nombre de connexions actuelles. 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.

Syntaxe

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Membres

shi2_netname

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

shi2_type

Combinaison de valeurs qui spécifient le type de la ressource partagée. 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	Lecteur de 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 Fonctions de partage réseau.
STYPE_TEMPORARY	Partage temporaire.

shi2_remark

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

shi2_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. Un serveur exécutant la sécurité au niveau de l’utilisateur ignore ce membre. Ce membre peut être une ou plusieurs 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.

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.

shi2_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.

shi2_current_uses

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

shi2_path

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

shi2_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é. Le membre shi2_passwd ne peut pas dépasser SHPWLEN+1 octets (y compris un caractère null de fin). Les appels à la fonction NetShareSetInfo ignorent ce membre. Notez que Windows ne prend pas en charge la sécurité au niveau du partage.

Spécifications


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