estrutura SYSTEM_AUDIT_CALLBACK_ACE (winnt.h)

  • Artigo

A estrutura SYSTEM_AUDIT_CALLBACK_ACE define uma ACE (entrada de controle de acesso ) para a SACL ( lista de controle de acesso do sistema ) que especifica quais tipos de acesso causam notificações no nível do sistema. Uma ACE de auditoria do sistema faz com que uma mensagem de auditoria seja registrada quando um administrador especificado tenta obter acesso a um objeto. O administrador é identificado por um SID ( identificador de segurança ).

Quando a função AuthzAccessCheck é chamada, cada estrutura SYSTEM_AUDIT_CALLBACK_ACE contida na DACL de uma estrutura SECURITY_DESCRIPTOR passada por um ponteiro para a função AuthzAccessCheck invoca uma chamada para a função AuthzAccessCheckCallback definida pelo aplicativo, na qual um ponteiro para a estrutura SYSTEM_AUDIT_CALLBACK_ACE encontrada é passado no parâmetro pAce .

Sintaxe

typedef struct _SYSTEM_AUDIT_CALLBACK_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       SidStart;
} SYSTEM_AUDIT_CALLBACK_ACE, *PSYSTEM_AUDIT_CALLBACK_ACE;

Membros

Header

ACE_HEADER estrutura que especifica o tamanho e o tipo de ACE. Ele também contém sinalizadores que controlam a herança do ACE por objetos filho. O membro AceType da estrutura ACE_HEADER deve ser definido como SYSTEM_AUDIT_CALLBACK_ACE_TYPE e o membro AceSize deve ser definido como o número total de bytes alocados para a estrutura de SYSTEM_AUDIT_CALLBACK_ACE .

Mask

Especifica uma estrutura ACCESS_MASK que fornece os direitos de acesso que fazem com que as mensagens de auditoria sejam geradas. Os sinalizadores SUCCESSFUL_ACCESS_ACE_FLAG e FAILED_ACCESS_ACE_FLAG no membro AceFlags da estrutura ACE_HEADER indicam se as mensagens são geradas para tentativas de acesso bem-sucedidas, tentativas de acesso malsucedidas ou ambas.

SidStart

O primeiro DWORD do SID de um administrador. Os bytes restantes do SID são armazenados na memória contígua após o membro SidStart . Esse SID pode ser acrescentado com os dados do aplicativo.

Comentários

As estruturas ACE devem ser alinhadas nos limites do DWORD . Todas as funções de gerenciamento de memória do Windows retornam identificadores alinhados a DWORD à memória.

Quando uma estrutura SYSTEM_AUDIT_CALLBACK_ACE é criada, a memória suficiente deve ser alocada para acomodar o SID completo do administrador no membro SidStart e a memória contígua que a segue.

Requisitos

   
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]
Cabeçalho winnt.h (inclua Windows.h)

Confira também

ACL

AddAuditAccessObjectAce

GUID

SID