Compartilhar via


estrutura SYSTEM_ALARM_CALLBACK_OBJECT_ACE (winnt.h)

Não há suporte.

A estrutura SYSTEM_ALARM_CALLBACK_OBJECT_ACE é reservada para uso futuro.

Sintaxe

typedef struct _SYSTEM_ALARM_CALLBACK_OBJECT_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       Flags;
  GUID        ObjectType;
  GUID        InheritedObjectType;
  DWORD       SidStart;
} SYSTEM_ALARM_CALLBACK_OBJECT_ACE, *PSYSTEM_ALARM_CALLBACK_OBJECT_ACE;

Membros

Header

ACE_HEADER estrutura que especifica o tamanho e o tipo de ACE. Ele contém sinalizadores que controlam a herança do ACE por objetos filho. A estrutura também contém sinalizadores que indicam se a ACE audita tentativas de acesso bem-sucedidas, tentativas de acesso com falha ou ambas. O membro AceType da estrutura ACE_HEADER deve ser definido como SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE.

Mask

Um ACCESS_MASK que especifica os direitos de acesso que o sistema auditará para tentativas de acesso pelo administrador.

Flags

Um conjunto de sinalizadores de bits que indicam se os membros ObjectType e InheritedObjectType contêm GUIDs. Esse parâmetro pode ser uma combinação dos seguintes valores. Defina todos os bits indefinidos como zero.

Valor Significado
ACE_OBJECT_TYPE_PRESENT
O membro ObjectType contém um GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT
O membro InheritedObjectType contém um GUID.

ObjectType

Uma estrutura GUID que identifica um conjunto de propriedades, uma propriedade, um direito estendido ou um tipo de objeto filho.

Esse membro só será válido se o bit ACE_OBJECT_TYPE_PRESENT estiver definido no membro Flags . Caso contrário, ObjectType será ignorado.

A finalidade desse GUID depende dos direitos de acesso especificados no membro Mask .

Valor Significado
ADS_RIGHT_DS_READ_PROP e/ou ADS_RIGHT_DS_WRITE_PROP
O GUID ObjectType identifica um conjunto de propriedades ou uma propriedade do objeto . A ACE controla a auditoria das tentativas do administrador de ler ou gravar a propriedade ou o conjunto de propriedades.
ADS_RIGHT_DS_CONTROL_ACCESS
O GUID ObjectType identifica um direito de acesso estendido.
ADS_RIGHT_DS_CREATE_CHILD
O GUID ObjectType identifica um tipo de objeto filho. A ACE controla a auditoria das tentativas do administrador de criar esse tipo de objeto filho.
ADS_RIGHT_DS_SELF
O GUID ObjectType identifica uma gravação validada.

InheritedObjectType

Uma estrutura GUID que identifica o tipo de objeto filho que pode herdar o ACE.

Esse membro só será válido se o bit ACE_INHERITED_OBJECT_TYPE_PRESENT estiver definido no membro Flags . Se esse bit não estiver definido, InheritedObjectType será ignorado e todos os tipos de objetos filho poderão herdar o ACE. Em ambos os casos, a herança também é controlada pelos sinalizadores de herança no ACE_HEADER, bem como por qualquer proteção contra herança colocada nos objetos filho.

SidStart

O primeiro DWORD da ACE de um administrador. Essa ACE pode ser acrescentada com os dados do aplicativo. Quando a função AuthzAccessCheckCallback é chamada, essa ACE é passada como o parâmetro pAce dessa função.

Comentários

Se nem o ObjectType nem o GUID InheritedObjectType forem especificados, a estrutura SYSTEM_ALARM_CALLBACK_OBJECT_ACE terá a mesma semântica que a estrutura SYSTEM_ALARM_CALLBACK_ACE . Nesse caso, use a estrutura SYSTEM_ALARM_CALLBACK_ACE porque ela é menor e mais eficiente.

Uma ACL que contém um SYSTEM_ALARM_CALLBACK_OBJECT_ACE deve especificar o número de revisão ACL_REVISION_DS em sua estrutura de ACE_HEADER .

Requisitos

Requisito Valor
Cabeçalho winnt.h