Função SetSecurityDescriptorOwner (securitybaseapi.h)

Artigo
03/15/2023

A função SetSecurityDescriptorOwner 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 já presentes no descritor de segurança.

Sintaxe

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Parâmetros

[in, out] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR cujo proprietário é definido por essa função. A função substitui qualquer proprietário existente pelo novo proprietário.

[in, optional] pOwner

Um ponteiro para uma estrutura sid para o novo proprietário primário do descritor de segurança. A estrutura sid é referenciada por, não copiado no descritor de segurança. Se esse parâmetro for NULL, a função limpará as informações de proprietário do descritor de segurança. Isso marca o descritor de segurança como sem proprietário.

[in] bOwnerDefaulted

Indica se as informações de proprietário são derivadas de um mecanismo padrão. Se esse valor for TRUE, serão informações padrão. A função armazena esse valor como o sinalizador SE_OWNER_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL . Se esse parâmetro for zero, o sinalizador SE_OWNER_DEFAULTED estará limpo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll