Função RtlCreateSecurityDescriptorRelative (ntifs.h)

Artigo
02/26/2024

A rotina RtlCreateSecurityDescriptorRelative inicializa um novo descritor de segurança no formato auto-relativo. No retorno, o descritor de segurança é inicializado sem NENHUMA ACL do sistema (SACL), nenhuma ACL discricionária (DACL), nenhum proprietário, nenhum grupo primário e todos os sinalizadores de controle definidos como zero.

Sintaxe

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Parâmetros

[out] SecurityDescriptor

Ponteiro para um buffer alocado pelo chamador, que deve ser pelo menos sizeof(SECURITY_DESCRIPTOR_RELATIVE), para receber o descritor de segurança inicializado.

[in] Revision

Nível de revisão a ser atribuído ao descritor de segurança. Esse parâmetro deve ser SECURITY_DESCRIPTOR_REVISION.

Retornar valor

RtlCreateSecurityDescriptorRelative pode retornar um dos seguintes:

Código de retorno	Descrição
STATUS_SUCCESS	Chamada concluída com êxito.
STATUS_UNKNOWN_REVISION	A Revisão fornecida não é conhecida ou não tem suporte.

Comentários

Na verdade, uma chamada bem-sucedida para essa rotina inicializa um descritor de segurança sem restrições de segurança.

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 2000
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL