Função EditSecurity (aclui.h)

Artigo
02/23/2024

A função EditSecurity exibe uma folha de propriedades que contém uma página de propriedades de segurança básica. Essa página de propriedades permite que o usuário exiba e edite os direitos de acesso permitidos ou negados pelas ACEs na DACL de um objeto.

Sintaxe

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

Parâmetros

[in] hwndOwner

Um identificador para a janela que possui a folha de propriedades. Este parâmetro pode ser NULL.

[in] psi

Um ponteiro para a implementação da interface ISecurityInformation . O sistema chama os métodos de interface para recuperar informações sobre o objeto que está sendo editado e para retornar a entrada do usuário.

Retornar valor

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

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

Comentários

A função EditSecurity chama a função CreateSecurityPage para criar uma página de propriedades de segurança básica.

Durante a inicialização da página de propriedades, o sistema chama os métodos ISecurityInformation::GetSecurity e ISecurityInformation::SetSecurity para determinar se o usuário tem permissão para editar o descritor de segurança do objeto. O sistema exibirá uma mensagem de erro se o usuário não tiver permissão.

A página de propriedades de segurança básica pode incluir um botão Avançado para exibir a folha de propriedades de segurança avançada. Essa folha de propriedades de segurança avançada pode conter três páginas de propriedades adicionais que permitem que o usuário exiba e edite a DACL, a SACL e o proprietário do objeto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	aclui.h
Biblioteca	Aclui.lib
DLL	Aclui.dll