Partilhar via


AtlGetSacl

Chamar essa função para recuperar informações de (SACL) da lista de controle de acesso do sistema de um objeto especificado.

Observação importanteImportante

Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.

inline bool AtlGetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CSacl* pSacl,
bool bRequestNeededPrivileges= true
) throw(...);

Parâmetros

  • hObject
    Identificador de que o objeto para recuperar 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 .

  • pSacl
    Ponteiro para um objeto de SACL que contém informações de segurança recuperada.

  • 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

Se AtlGetSacl 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

Consulte também

Referência

AtlSetSacl

Classe de CSacl

Outros recursos

Funções de segurança globais