Método ISecurityInformation::GetSecurity (aclui.h)
O método GetSecurity solicita um descritor de segurança para o objeto protegível cujo descritor de segurança está sendo editado. O editor de controle de acesso chama esse método para recuperar o descritor de segurança atual ou padrão do objeto.
Sintaxe
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
Parâmetros
[in] RequestedInformation
Um conjunto de SECURITY_INFORMATION sinalizadores de bits que indicam as partes do descritor de segurança que está sendo solicitado. Esse parâmetro pode ser uma combinação dos seguintes valores.
[out] ppSecurityDescriptor
Um ponteiro para uma variável que sua implementação deve definir como um ponteiro para o descritor de segurança do objeto. O descritor de segurança deve incluir os componentes solicitados pelo parâmetro RequestedInformation .
O sistema chama a função LocalFree para liberar o ponteiro retornado.
[in] fDefault
Se esse parâmetro for TRUE, ppSecurityDescriptor deverá retornar um descritor de segurança padrão definido pelo aplicativo para o objeto. O editor de controle de acesso usa esse descritor de segurança padrão para reinicializar a página de propriedades.
O editor de controle de acesso define esse parâmetro como TRUE somente se o usuário clicar no botão Padrão . O botão Padrão será exibido somente se você definir o sinalizador SI_RESET no método ISecurityInformation::GetObjectInformation . Se nenhum descritor de segurança padrão estiver disponível, não defina o sinalizador SI_RESET.
Se esse sinalizador for FALSE, ppSecurityDescriptor deverá retornar o descritor de segurança atual do objeto.
Retornar valor
Retorna S_OK se tiver êxito.
Retorna um código de erro diferente de zero se ocorrer um erro. Retorna E_ACCESSDENIED se o usuário não tiver permissão para ler as informações de segurança solicitadas.
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 |
Confira também
Funções do Editor Controle de Acesso