Função RtlGetOwnerSecurityDescriptor (ntifs.h)

Artigo
02/07/2025

A rotina RtlGetOwnerSecurityDescriptor retorna as informações de proprietário de um determinado descritor de segurança.

Sintaxe

NTSYSAPI NTSTATUS RtlGetOwnerSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Owner,
  [out] PBOOLEAN             OwnerDefaulted
);

Parâmetros

[in] SecurityDescriptor

Ponteiro para o descritor de segurança.

[out] Owner

Ponteiro para um endereço para receber um ponteiro para o identificador de segurança do proprietário (SID). Se o descritor de segurança não contiver atualmente um SID proprietário, Proprietário receberá NULL.

[out] OwnerDefaulted

Ponteiro para uma variável booliana que recebe VERDADEIRO se as informações do proprietário forem derivadas de um mecanismo padrão, e não pelo provedor original do descritor de segurança explicitamente, FALSE caso contrário. Válido somente se Proprietário receber um valor deNULL não.

Valor de retorno

RtlGetOwnerSecurityDescriptor retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_UNKNOWN_REVISION	O nível de revisão do descritor de segurança não é conhecido 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 2000
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL	PASSIVE_LEVEL