Função RtlGetSaclSecurityDescriptor (ntifs.h)

Artigo
02/07/2025

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 cujo SACL deve ser retornado.

[out] SaclPresent

Ponteiro para uma variável booliana que indica a presença de um SACL no descritor de segurança especificado. Se essa variável receber verdadeiro, o descritor de segurança conterá um 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á um 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 do SACL para o descritor de segurança. Se o descritor de segurança não tiver um SACL, essa variável não receberá um valor. Se o descritor de segurança tiver um 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 um SACL para o descritor de segurança.

Valor de retorno

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.

Observações

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
de cliente com suporte mínimo	Windows Server 2003 SP1
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL