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

  • Artigo

O método SetSecurity fornece um descritor de segurança que contém as informações de segurança que o usuário deseja aplicar ao objeto protegível. O editor de controle de acesso chama esse método quando o usuário clica em Ok ou Aplicar.

Sintaxe

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parâmetros

[in] SecurityInformation

Um conjunto de sinalizadores de bits SECURITY_INFORMATION que indicam as partes do descritor de segurança a ser definido. Esse parâmetro pode ser uma combinação dos seguintes valores.

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

[in] pSecurityDescriptor

Um ponteiro para um descritor de segurança que contém as novas informações de segurança. Não suponha que o descritor de segurança esteja em forma auto-relativa ; pode ser absoluto ou auto-relativo.

Retornar valor

Retorna S_OK se tiver êxito.

Retorna um código de erro diferente de zero se ocorrer um erro.

Comentários

Para criar um descritor de segurança completo para o objeto, o aplicativo deve mesclar as novas partes do descritor de segurança, conforme definido pelo parâmetro SecurityInformation , no descritor de segurança existente 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

Confira também

Editor Controle de Acesso

Funções do Editor Controle de Acesso

ISecurityInformation

SECURITY_INFORMATION