Função RtlGetOwnerSecurityDescriptor (ntifs.h)

Artigo
02/26/2024

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 SID (identificador de segurança) do proprietário. Se o descritor de segurança não contiver um SID proprietário no momento, o Proprietário receberá NULL.

[out] OwnerDefaulted

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

Retornar valor

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.

Comentários

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	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL	PASSIVE_LEVEL