Fonction RtlGetSaclSecurityDescriptor (ntifs.h)

Article
03/08/2023

La routine RtlGetSaclSecurityDescriptor retourne un pointeur vers la liste de contrôle d’accès système (SACL) pour 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 le SECURITY_DESCRIPTOR dont la liste SACL 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 SACL 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 SACL pour le descripteur de sécurité. Si le descripteur de sécurité n’a pas de sacl, cette variable ne reçoit pas de valeur. Si le descripteur de sécurité a une liste SACL NULL , cette variable reçoit NULL.

[out] SaclDefaulted

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

Valeur retournée

RtlGetSaclSecurityDescriptor retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que :

Code de retour	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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Server 2003 SP1
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL