AtlSetSacl
Chamar essa função para definir informações de (SACL) da lista de controle de acesso do sistema de um objeto especificado.
Importante
Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.
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 de que que define informações de segurança.ObjectType
Especifica um valor de enumeração de SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro de hObject .rSacl
O SACL que contém as novas informações de segurança.dwInheritanceFlowControl
O controle de fluxo de herança. Esse valor pode ser 0 (o padrão), PROTECTED_SACL_SECURITY_INFORMATION ou UNPROTECTED_SACL_SECURITY_INFORMATION.bRequestNeededPrivileges
Se verdadeiro, a função tentará ativar o privilégio de SE_SECURITY_NAME, e restaurar-lo na conclusão.
Valor de retorno
Retorna verdadeiros em êxito, falso em caso de falha.
Comentários
Em compilações de depuração, um erro ocorrerá se hObject de declaração não é válida, ou se dwInheritanceFlowControl não é um dos três valores permitidos.
Se AtlSetSacl deve ser chamado várias vezes em vários objetos diferentes, será mais eficiente ativar uma vez do privilégio SE_SECURITY_NAME antes de chamar a função, com bRequestNeededPrivileges definido como false.
Requisitos
Cabeçalho: atlsecurity.h