Função RtlGetSaclSecurityDescriptor (ntifs.h)

Artigo
03/08/2023

A rotina RtlGetSaclSecurityDescriptor retorna um ponteiro para a ACL do sistema (SACL) para um descritor de segurança.

Sintaxe

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

Parâmetros

[in] SecurityDescriptor

Ponteiro para o SECURITY_DESCRIPTOR cuja SACL deve ser retornada.

[out] SaclPresent

Ponteiro para uma variável booliana que indica a presença de uma SACL no descritor de segurança especificado. Se essa variável receber TRUE, o descritor de segurança conterá uma SACL e os parâmetros de saída restantes receberão valores válidos. Se essa variável receber FALSE, o descritor de segurança não conterá uma SACL e os parâmetros de saída restantes não receberão valores válidos.

[out] Sacl

Ponteiro para uma variável que recebe o endereço da SACL para o descritor de segurança. Se o descritor de segurança não tiver uma SACL, essa variável não receberá um valor. Se o descritor de segurança tiver uma SACL NULL , essa variável receberá NULL.

[out] SaclDefaulted

Ponteiro para uma variável booliana que recebe o valor do sinalizador SE_SACL_DEFAULTED na estrutura de SECURITY_DESCRIPTOR_CONTROL do descritor de segurança se houver uma SACL para o descritor de segurança.

Retornar valor

RtlGetSaclSecurityDescriptor retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_UNKNOWN_REVISION	O nível de revisão do descritor de segurança é desconhecido ou não tem suporte. Este é um código de erro.

Comentários

Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Server 2003 SP1
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL