Função SetSecurityDescriptorOwner (securitybaseapi.h)
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 |
Confira também
Controle de Acesso de baixo nível