AtlSetSacl
Chamar essa função para definir informações de (SACL) da lista de controle de acesso do sistema de um objeto especificado.
.gif "Observação importante") 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