Partager via

SHARE_INFO_502 structure (lmshare.h)

  • Article

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

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Fonctions de partage réseau