Compartilhar via


Função AddAuditAccessAce (securitybaseapi.h)

A função AddAuditAccessAce adiciona uma ACE ( entrada de controle de acesso ) de auditoria do sistema a uma ACL (lista de controle de acesso do sistema). O acesso de um SID ( identificador de segurança ) especificado é auditado.

Para controlar se o novo ACE pode ser herdado por objetos filho, use a função AddAuditAccessAceEx .

Sintaxe

BOOL AddAuditAccessAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceRevision,
  [in]      DWORD dwAccessMask,
  [in]      PSID  pSid,
  [in]      BOOL  bAuditSuccess,
  [in]      BOOL  bAuditFailure
);

Parâmetros

[in, out] pAcl

Um ponteiro para uma ACL. Essa função adiciona uma ACE de auditoria do sistema a essa ACL. O ACE está na forma de uma estrutura SYSTEM_AUDIT_ACE .

[in] dwAceRevision

Especifica o nível de revisão da ACL que está sendo modificada.

Esse valor pode ser ACL_REVISION ou ACL_REVISION_DS. Use ACL_REVISION_DS se a ACL contiver ACEs específicas do objeto.

[in] dwAccessMask

Especifica a máscara de direitos de acesso a ser auditada para o SID especificado.

[in] pSid

Um ponteiro para o SID que representa o processo cujo acesso está sendo auditado.

[in] bAuditSuccess

Especifica se as tentativas de acesso bem-sucedidas devem ser auditadas. Defina esse sinalizador como TRUE para habilitar a auditoria; caso contrário, defina-o como FALSE.

[in] bAuditFailure

Especifica se tentativas de acesso malsucedidas devem ser auditadas. Defina esse sinalizador como TRUE para habilitar a auditoria; caso contrário, defina-o como FALSE.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Veja a seguir valores de erro possíveis.

Código de retorno Descrição
ERROR_ALLOTTED_SPACE_EXCEEDED
O novo ACE não se encaixa na ACL. Um buffer de ACL maior é necessário.
ERROR_INVALID_ACL
A ACL especificada não é formada corretamente.
ERROR_INVALID_SID
O SID especificado não é estruturalmente válido.
ERROR_REVISION_MISMATCH
A revisão especificada não é conhecida ou é incompatível com a da ACL.
ERROR_SUCCESS
O ACE foi adicionado com êxito.

Comentários

A estrutura ACE_HEADER colocada no ACE pela função AddAuditAccessAce especifica um tipo e um tamanho, mas não fornece sinalizadores ACE.

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 securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

ACE_HEADER

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAceEx

DeleteAce

GetAce

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível

SYSTEM_AUDIT_ACE