Fonction InitializeSecurityDescriptor (securitybaseapi.h)

Article
08/25/2023

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