Função CreateSecurityPage (aclui.h)

Artigo
02/26/2024

A função CreateSecurityPage cria uma página de propriedades de segurança básica que permite que o usuário exiba e edite os direitos de acesso permitidos ou negados pelas ACEs ( entradas de controle de acesso ) na DACL ( lista de controle de acesso discricionário ) de um objeto. Use a função PropertySheet ou a mensagem PSM_ADDPAGE para adicionar esta página a uma folha de propriedades.

Sintaxe

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

Parâmetros

[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, a função retornará um identificador para uma página de propriedades de segurança básica.

Se a função falhar, ela retornará NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

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 ao usuário exibir e editar a DACL do objeto, a SACL ( lista de controle de acesso do sistema ) e o proprietário.

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