Função RtlCreateSecurityDescriptorRelative (ntifs.h)

Artigo
02/07/2025

A rotina RtlCreateSecurityDescriptorRelative inicializa um novo descritor de segurança em formato auto-relativo. No retorno, o descritor de segurança é inicializado sem 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 por chamador, que deve ter pelo menos tamanho de(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.

Valor de retorno

RtlCreateSecurityDescriptorRelative pode retornar um dos seguintes:

Código de retorno	Descrição
STATUS_SUCCESS	A chamada foi concluída com êxito.
STATUS_UNKNOWN_REVISION	O de Revisão de determinado não é conhecido ou não tem suporte.

Observações

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
de cliente com suporte mínimo	Windows 2000
da Plataforma de Destino	Área de trabalho
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL