structure SI_ACCESS (aclui.h)

Article
02/23/2024

La structure SI_ACCESS contient des informations sur un droit d’accès ou un masque d’accès par défaut pour un objet sécurisable. La méthode ISecurityInformation ::GetAccessRights utilise cette structure pour spécifier les informations que l’éditeur de contrôle d’accès utilise pour initialiser ses pages de propriétés.

Syntaxe

typedef struct _SI_ACCESS {
  const GUID  *pguid;
  ACCESS_MASK mask;
  LPCWSTR     pszName;
  DWORD       dwFlags;
} SI_ACCESS, *PSI_ACCESS;

Membres

pguid

Pointeur vers une structure GUID qui identifie le type d’objet auquel le droit d’accès ou le masque d’accès par défaut s’applique. Le GUID peut identifier un jeu de propriétés ou une propriété sur l’objet, ou un type d’objet enfant qui peut être contenu par l’objet.

Si ce membre pointe vers GUID_NULL, le droit d’accès s’applique à l’objet lui-même.

mask

Masque de bits qui spécifie le droit d’accès décrit par cette structure. Le masque peut contenir n’importe quelle combinaison de droits standard et spécifiques, mais ne doit pas contenir de droits génériques tels que GENERIC_ALL.

pszName

Pointeur vers une chaîne Unicode terminée par null contenant une chaîne d’affichage qui décrit le droit d’accès.

PszName peut également être un identificateur de ressource de chaîne retourné par la macro MAKEINTRESOURCE. Utilisez la méthode ISecurityInformation ::GetObjectInformation pour identifier le module qui contient la ressource de chaîne.

dwFlags

Ensemble d’indicateurs de bits qui indiquent où le droit d’accès est affiché. Ce membre peut être une combinaison des éléments suivants.

Valeur	Signification
SI_ACCESS_SPECIFIC	Le droit d’accès s’affiche sur les pages de sécurité avancée.
SI_ACCESS_GENERAL	Le droit d’accès s’affiche sur la page de sécurité de base.
SI_ACCESS_CONTAINER	Indique un droit d’accès qui s’applique uniquement aux conteneurs. Si cet indicateur est défini, le droit d’accès s’affiche sur la page de sécurité de base uniquement si la méthode ISecurityInformation ::GetObjectInformation spécifie l’indicateur SI_CONTAINER.
SI_ACCESS_PROPERTY	Indique un droit d’accès spécifique à la propriété. Utilisé avec SI_EDIT_PROPERTIES.

Ce membre peut également spécifier une combinaison des indicateurs suivants pour indiquer si d’autres conteneurs ou objets peuvent hériter du droit d’accès.

Valeur	Signification
CONTAINER_INHERIT_ACE	Les autres conteneurs contenus par l’objet principal héritent de l’entrée.
INHERIT_ONLY_ACE	L’ACE ne s’applique pas à l’objet principal auquel l’ACL est attachée, mais les objets contenus par l’objet principal héritent de l’entrée.
OBJECT_INHERIT_ACE	Les objets non-contenus contenus par l’objet principal héritent de l’entrée.

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	aclui.h

Voir aussi

GUID

ISecurityInformation ::GetAccessRights

ISecurityInformation ::GetObjectInformation

Share via