GetSecurityDescriptorLength, fonction (securitybaseapi.h)

Article
03/04/2024

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