Partager via


Fonction InitializeSecurityDescriptor (securitybaseapi.h)

La fonction InitializeSecurityDescriptor initialise un nouveau descripteur de sécurité.

Syntaxe

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

Paramètres

[out] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR que la fonction initialise.

[in] dwRevision

Niveau de révision à affecter au descripteur de sécurité. Ce paramètre doit être SECURITY_DESCRIPTOR_REVISION.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

La fonction InitializeSecurityDescriptor initialise un descripteur de sécurité au format absolu , plutôt qu’au format auto-relatif .

La fonction InitializeSecurityDescriptor initialise un descripteur de sécurité pour n’avoir aucune liste de contrôle d’accès système (SACL), aucune liste de contrôle d’accès discrétionnaire (DACL), aucun propriétaire, aucun groupe principal et tous les indicateurs de contrôle définis sur FALSE (NULL). Ainsi, à l’exception de son niveau de révision, il est vide.

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Création d’un descripteur de sécurité pour un nouvel objet.

Spécifications

   
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]
Plateforme cible Windows
En-tête securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Access Control de bas niveau

Fonctions Access Control de bas niveau

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl