SHARE_INFO_2 structure (lmshare.h)

  • Article

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

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Fonctions de partage réseau