SECURITY_DESCRIPTOR structure (winnt.h)

Article
08/27/2023

La structure SECURITY_DESCRIPTOR contient les informations de sécurité associées à un objet . Les applications utilisent cette structure pour définir et interroger les status de sécurité d’un objet.

Étant donné que le format interne d’un descripteur de sécurité peut varier, nous recommandons aux applications de ne pas modifier directement la structure SECURITY_DESCRIPTOR . Pour créer et manipuler un descripteur de sécurité, utilisez les fonctions répertoriées dans Voir aussi.

Syntaxe

typedef struct _SECURITY_DESCRIPTOR {
  BYTE                        Revision;
  BYTE                        Sbz1;
  SECURITY_DESCRIPTOR_CONTROL Control;
  PSID                        Owner;
  PSID                        Group;
  PACL                        Sacl;
  PACL                        Dacl;
} SECURITY_DESCRIPTOR, *PISECURITY_DESCRIPTOR;

Membres

Revision

Sbz1

Control

Owner

Group

Sacl

Dacl

Remarques

Un descripteur de sécurité inclut des informations qui spécifient les composants suivants de la sécurité d’un objet :

Identificateur de sécurité du propriétaire (SID)
Un SID de groupe principal
Une liste de contrôle d’accès discrétionnaire (DACL)
Une liste de contrôle d’accès système (SACL)
Qualificateurs pour les éléments précédents

Plusieurs fonctions qui utilisent la structure SECURITY_DESCRIPTOR nécessitent que cette structure soit alignée sur une limite de pointeur valide en mémoire. Ces limites varient en fonction du type de processeur utilisé. Les fonctions d’allocation de mémoire telles que malloc et LocalAlloc retournent des pointeurs correctement alignés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
En-tête	winnt.h (inclure Windows.h)