Função RtlCreateSecurityDescriptor (wdm.h)

  • Artigo

A rotina RtlCreateSecurityDescriptor inicializa um novo descritor de segurança de formato absoluto. No retorno, o descritor de segurança é inicializado sem ACL do sistema, sem ACL discricionária, sem proprietário, sem grupo primário e todos os sinalizadores de controle definidos como zero.

Sintaxe

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  ULONG                Revision
);

Parâmetros

[out] SecurityDescriptor

Ponteiro para o buffer para o SECURITY_DESCRIPTOR a ser inicializado.

[in] Revision

Especifica o nível de revisão a ser atribuído ao descritor de segurança. Defina esse parâmetro como SECURITY_DESCRIPTOR_REVISION.

Retornar valor

RtlCreateSecurityDescriptor pode retornar um dos seguintes.

Código de retorno Descrição
STATUS_SUCCESS
 Chamada concluída com êxito.
STATUS_UNKNOWN_REVISION
 O chamador especificou um valor sem suporte para Revisão.

Comentários

Uma chamada bem-sucedida para essa rotina inicializa um descritor de segurança. Os campos nesse descritor são definidos como valores iniciais que indicam que não há restrições de segurança.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL PASSIVE_LEVEL

Confira também

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR