RtlGetSaclSecurityDescriptor, fonction (ntifs.h)

Article
02/07/2025

La routine RtlGetSaclSecurityDescriptor retourne un pointeur vers la liste de contrôle d’accès système (SACL) d’un descripteur de sécurité.

Syntaxe

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

Paramètres

[in] SecurityDescriptor

Pointeur vers la SECURITY_DESCRIPTOR dont la liste de contrôle d’accès partagé doit être retournée.

[out] SaclPresent

Pointeur vers une variable booléenne qui indique la présence d’une liste de contrôle d’accès partagé dans le descripteur de sécurité spécifié. Si cette variable reçoit TRUE, le descripteur de sécurité contient une liste de contrôle d’accès partagé et les paramètres de sortie restants reçoivent des valeurs valides. Si cette variable reçoit FALSE, le descripteur de sécurité ne contient pas de liste de contrôle d’accès partagé et les paramètres de sortie restants ne reçoivent pas de valeurs valides.

[out] Sacl

Pointeur vers une variable qui reçoit l’adresse de la liste de contrôle d’accès partagé pour le descripteur de sécurité. Si le descripteur de sécurité n’a pas de liste de contrôle d’accès partagé, cette variable ne reçoit pas de valeur. Si le descripteur de sécurité a une SACL NULL, cette variable reçoit NULL .

[out] SaclDefaulted

Pointeur vers une variable booléenne qui reçoit la valeur de l’indicateur de SE_SACL_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL du descripteur de sécurité si une liste de contrôle d’accès partagé existe pour le descripteur de sécurité.

Valeur de retour

RtlGetSaclSecurityDescriptor retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Retourner le code	Description
STATUS_UNKNOWN_REVISION	Le niveau de révision du descripteur de sécurité est inconnu ou n’est pas pris en charge. Il s’agit d’un code d’erreur.

Remarques

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Server 2003 SP1
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL