Método ISecurityInformation::GetSecurity (aclui.h)

  • Artigo

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.

Valor Significado
OWNER_SECURITY_INFORMATION
 O descritor de segurança deve incluir o SID do proprietário do objeto.
GROUP_SECURITY_INFORMATION
 O descritor de segurança deve incluir o SID do grupo primário do objeto.
DACL_SECURITY_INFORMATION
 O descritor de segurança deve incluir a DACL do objeto.
SACL_SECURITY_INFORMATION
 O descritor de segurança deve incluir a SACL do objeto.

[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

Editor de Controle de Acesso

Funções do Editor Controle de Acesso

ISecurityInformation

ISecurityInformation::GetObjectInformation

Localfree

SECURITY_INFORMATION