Función RtlGetSaclSecurityDescriptor (ntifs.h)

Artículo
03/08/2023

La rutina RtlGetSaclSecurityDescriptor devuelve un puntero a la ACL del sistema (SACL) para un descriptor de seguridad.

Sintaxis

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

Parámetros

[in] SecurityDescriptor

Puntero al SECURITY_DESCRIPTOR cuyo SACL se va a devolver.

[out] SaclPresent

Puntero a una variable booleana que indica la presencia de una SACL en el descriptor de seguridad especificado. Si esta variable recibe TRUE, el descriptor de seguridad contiene una SACL y los parámetros de salida restantes reciben valores válidos. Si esta variable recibe FALSE, el descriptor de seguridad no contiene una SACL y los parámetros de salida restantes no reciben valores válidos.

[out] Sacl

Puntero a una variable que recibe la dirección del SACL para el descriptor de seguridad. Si el descriptor de seguridad no tiene una SACL, esta variable no recibe un valor. Si el descriptor de seguridad tiene un SACL NULL , esta variable recibe NULL.

[out] SaclDefaulted

Puntero a una variable booleana que recibe el valor de la marca de SE_SACL_DEFAULTED en la estructura de SECURITY_DESCRIPTOR_CONTROL del descriptor de seguridad si existe una SACL para el descriptor de seguridad.

Valor devuelto

RtlGetSaclSecurityDescriptor devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Código devuelto	Descripción
STATUS_UNKNOWN_REVISION	El nivel de revisión del descriptor de seguridad es desconocido o no se admite. Se trata de un código de error.

Comentarios

Para obtener más información sobre la seguridad y el control de acceso, consulte Modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Server 2003 SP1
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL