Partager via


GetSecurityDescriptorLength, fonction (securitybaseapi.h)

La fonction GetSecurityDescriptorLength retourne la longueur, en octets, d’un descripteur de sécurité structurellement valide. La longueur inclut la longueur de toutes les structures associées.

Syntaxe

DWORD GetSecurityDescriptorLength(
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Paramètres

[in] pSecurityDescriptor

Pointeur vers la structure SECURITY_DESCRIPTOR dont la fonction retourne la longueur. Le pointeur est supposé être valide.

Valeur retournée

Si la fonction réussit, la fonction retourne la longueur, en octets, de la structure SECURITY_DESCRIPTOR .

Si la structure SECURITY_DESCRIPTOR n’est pas valide, la valeur de retour n’est pas définie.

Remarques

La longueur minimale d’un descripteur de sécurité est SECURITY_DESCRIPTOR_MIN_LENGTH. Un descripteur de sécurité de cette longueur n’a pas d’identificateurs de sécurité (SID) ou de listes de contrôle d’accès (ACL) associé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]
Plateforme cible Windows
En-tête securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Access Control de bas niveau

Fonctions Access Control de bas niveau

SECURITY_DESCRIPTOR