structure SHARE_INFO_503 (lmshare.h)

Article
08/24/2023

Contient des informations sur la ressource partagée. Il est identique à la structure SHARE_INFO_502 , sauf qu’il contient également le nom du serveur.

Syntaxe

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Membres

shi503_netname

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

shi503_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 0x00000000	Lecteur de disque.
STYPE_PRINTQ 0x00000001	File d’attente d’impression.
STYPE_DEVICE 0x00000002	Appareil de communication.
STYPE_IPC 0x00000003	Communication interprocess (IPC).

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

Valeur	Signification
STYPE_SPECIAL 0x80000000	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 0x40000000	Un partage temporaire.

shi503_remark

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

shi503_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. Notez que Windows ne prend pas en charge la sécurité au niveau du partage. Ce membre est ignoré sur un serveur exécutant la sécurité au niveau de l’utilisateur. 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.

Les appels à la fonction NetShareSetInfo ignorent ce membre.

Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
ACCESS_READ 0x00000001	Autorisation de lire les données d’une ressource et, par défaut, d’exécuter la ressource.
ACCESS_WRITE 0x00000002	Autorisation d’écrire des données dans la ressource.
ACCESS_CREATE 0x00000004	Autorisation de créer un instance de la ressource (par exemple, un fichier) ; les données peuvent être écrites dans la ressource à mesure que la ressource est créée.
ACCESS_EXEC 0x00000008	Autorisation d’exécuter la ressource.
ACCESS_DELETE 0x00000010	Autorisation de supprimer la ressource.
ACCESS_ATRIB 0x00000020	Autorisation de modifier les attributs de la ressource (comme la date et l’heure de la dernière modification d’un fichier).
ACCESS_PERM 0x00000040	Autorisation de modifier les autorisations (lire, écrire, créer, exécuter et supprimer) attribuées à une ressource pour un utilisateur ou une application.
ACCESS_ALL 0x00008000	Autorisation de lire, d’écrire, de créer, d’exécuter et de supprimer des ressources, et de modifier leurs attributs et autorisations.

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

shi503_current_uses

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

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

shi503_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 la 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.

shi503_servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel réside la ressource partagée. La valeur « * » n’indique aucun nom de serveur configuré.

shi503_reserved

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

shi503_security_descriptor

Spécifie le SECURITY_DESCRIPTOR associé à ce partage.

Notes

Le serveur distant spécifié dans le membre shi503_servername doit avoir été lié à un protocole de transport à l’aide de la fonction NetServerTransportAddEx . Dans l’appel à NetServerTransportAddEx, 2 ou 3 doit avoir été spécifié pour le paramètre de niveau , et la valeur SVTI2_SCOPED_NAME doit avoir été spécifiée dans la structure SERVER_TRANSPORT_INFO_2 pour le protocole de transport.

Configuration requise


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)