Função AddAuditAccessAce (securitybaseapi.h)

Artigo
03/01/2024

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