Partilhar via


AtlSetSacl

telefonar Esta função para conjunto as informações de SACL (lista) do sistema de controle de acesso de um objeto especificado.

inline bool AtlSetSacl(
   HANDLE hObject,
   SE_OBJECT_TYPE ObjectType,
   const CSacl& rSacl,
   DWORD dwInheritanceFlowControl = 0,
   bool bRequestNeededPrivileges = true
) throw(...);

Parâmetros

  • hObject
    Identificador para o objeto para o qual conjunto as informações de segurança.

  • ObjectType
    Especifica um valor a partir de SE_OBJECT_TYPE enumeração que indica o tipo de objeto que possui o hObject parâmetro.

  • rSacl
    A SACL que contém as informações de segurança novo.

  • dwInheritanceFlowControl
    O controle de fluxo de herança.Esse valor pode ser 0 (padrão), PROTECTED_SACL_SECURITY_INFORMATION ou UNPROTECTED_SACL_SECURITY_INFORMATION.

  • bRequestNeededPrivileges
    Se verdadeiro, a função tentará ativar o privilégio SE_SECURITY_NAME e restaurá-lo após a conclusão.

Valor de retorno

Retorna verdadeiro sucesso, false em caso de falha.

Comentários

Em compilações de depurar, irá ocorrer um erro de asserção se hObject é inválido, ou se dwInheritanceFlowControl não é um dos três valores permitidos.

If AtlSetSacl deve ser chamado várias vezes em muitos objetos diferentes, será mais eficiente para habilitar o privilégio SE_SECURITY_NAME uma vez antes de chamar a função com bRequestNeededPrivileges conjunto para false.

Requisitos

Cabeçalho: atlsecurity.h

Consulte também

Referência

AtlGetSacl

Classe CSacl

Outros recursos

Segurança funções global