Partager via

structure SI_ACCESS (aclui.h)

  • Article

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