Função RtlSetOwnerSecurityDescriptor (ntifs.h)

Artigo
03/08/2023

A rotina RtlSetOwnerSecurityDescriptor define as informações de proprietário de um descritor de segurança de formato absoluto. Ele substitui todas as informações de proprietário que já estão presentes no descritor de segurança.

Sintaxe

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Parâmetros

[in, out] SecurityDescriptor

Ponteiro para a estrutura SECURITY_DESCRIPTOR cujo proprietário deve ser definido. RtlSetOwnerSecurityDescriptor substitui qualquer proprietário existente pelo novo proprietário.

[in, optional] Owner

Ponteiro para uma estrutura sid (identificador de segurança) para o novo proprietário primário do descritor de segurança. Esse ponteiro, não a estrutura sid em si, é copiado para o descritor de segurança. Se esse parâmetro for NULL, RtlSetOwnerSecurityDescriptor limpará as informações de proprietário do descritor de segurança. Isso marca o descritor de segurança como sem proprietário.

[in, optional] OwnerDefaulted

Defina como TRUE se as informações de proprietário forem derivadas de um mecanismo padrão. Se esse valor for TRUE, serão informações padrão. RtlSetOwnerSecurityDescriptor define o sinalizador SE_OWNER_DEFAULTED no campo SECURITY_DESCRIPTOR_CONTROL do descritor de segurança. Se esse parâmetro for FALSE, o sinalizador SE_OWNER_DEFAULTED será limpo.

Retornar valor

RtlSetOwnerSecurityDescriptor pode retornar um dos seguintes códigos de status:

Código de retorno	Descrição
STATUS_SUCCESS	O proprietário foi definido ou redefinido com êxito.
STATUS_UNKNOWN_REVISION	A versão do descritor de segurança fornecida não é reconhecida por essa rotina.
STATUS_INVALID_SECURITY_DESCR	O descritor de segurança especificado não é um descritor de segurança absoluto válido.

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
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	< DISPATCH_LEVEL