Partager via


Fonction RtlGetSaclSecurityDescriptor (ntifs.h)

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

Voir aussi

ACL

RtlCreateSecurityDescriptor

RtlGetDaclSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR