structure SECURITY_ATTRIBUTES (wtypesbase.h)

La structure SECURITY_ATTRIBUTES contient le descripteur de sécurité d’un objet et spécifie si le handle récupéré en spécifiant cette structure peut être hérité. Cette structure fournit des paramètres de sécurité pour les objets créés par différentes fonctions, telles que CreateFile, CreatePipe, CreateProcess, RegCreateKeyEx ou RegSaveKeyEx.

Syntaxe

typedef struct _SECURITY_ATTRIBUTES {
  DWORD  nLength;
  LPVOID lpSecurityDescriptor;
  BOOL   bInheritHandle;
} SECURITY_ATTRIBUTES, *PSECURITY_ATTRIBUTES, *LPSECURITY_ATTRIBUTES;

Membres

nLength

Taille, en octets, de cette structure. Définissez cette valeur sur la taille de la structure SECURITY_ATTRIBUTES .

lpSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR qui contrôle l’accès à l’objet. Si la valeur de ce membre est NULL, l’objet se voit attribuer le descripteur de sécurité par défaut associé au jeton d’accès du processus appelant. Cela ne revient pas à accorder l’accès à tout le monde en attribuant une liste de contrôle d’accès discrétionnaireNULL (DACL). Par défaut, la liste de contrôle d’accès par défaut dans le jeton d’accès d’un processus autorise uniquement l’accès à l’utilisateur représenté par le jeton d’accès.

Pour plus d’informations sur la création d’un descripteur de sécurité, consultez Création d’un descripteur de sécurité.

bInheritHandle

Valeur booléenne qui spécifie si le handle retourné est hérité lors de la création d’un nouveau processus. Si ce membre a la valeur TRUE, le nouveau processus hérite du handle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	wtypesbase.h