estrutura ACCESS_ALLOWED_OBJECT_ACE (winnt.h)

Artigo
07/16/2024

A estrutura de ACCESS_ALLOWED_OBJECT_ACE define uma ACE (entrada de controle de acesso) que controla o acesso permitido a um objeto, um conjunto de propriedades ou uma propriedade. O ACE contém um conjunto de direitos de acesso, um GUID que identifica o tipo de objeto e um SID ( identificador de segurança) que identifica o para quem o sistema concederá acesso. O ACE também contém um GUID e um conjunto de sinalizadores que controlam a herança do ACE por objetos filho.

Sintaxe

typedef struct _ACCESS_ALLOWED_OBJECT_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       Flags;
  GUID        ObjectType;
  GUID        InheritedObjectType;
  DWORD       SidStart;
} ACCESS_ALLOWED_OBJECT_ACE, *PACCESS_ALLOWED_OBJECT_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 ACCESS_ALLOWED_OBJECT_ACE_TYPE e o membro aceSize deve ser definido como o número total de bytes alocados para a estrutura de ACCESS_ALLOWED_OBJECT_ACE.

Mask

Um ACCESS_MASK que especifica os direitos de acesso que o sistema permitirá ao de administrador.

Flags

Um conjunto de sinalizadores de bits que indicam se os membros ObjectType e InheritedObjectType estão presentes. Esse parâmetro pode ser um ou mais dos valores a seguir.

Valor	Significado
0	Nem ObjectType nem InheritedObjectType estão presentes. O membro do SidStart segue imediatamente após o membro do Flags.
ACE_OBJECT_TYPE_PRESENT	ObjectType está presente e contém um GUID . Se esse valor não for especificado, o membro InheritedObjectType será seguido imediatamente após o membro do Flags.
ACE_INHERITED_OBJECT_TYPE_PRESENT	InheritedObjectType está presente e contém um guid . Se esse valor não for especificado, todos os tipos de objetos filho poderão herdar o ACE.

ObjectType

Esse membro só existirá se o bit ACE_OBJECT_TYPE_PRESENT estiver definido no membro sinalizadores do . Caso contrário, o membro InheritedObjectType segue imediatamente após o membro sinalizadores do .

Se esse membro existir, será uma estrutura de GUID que identifica um conjunto de propriedades, uma propriedade, um direito estendido ou um tipo de objeto filho. A finalidade deste GUID depende dos direitos de acesso especificados no membro Mask.

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

InheritedObjectType

Esse membro só existirá se o bit ACE_INHERITED_OBJECT_TYPE_PRESENT estiver definido no membro sinalizadores do .

Se esse membro existir, será uma estrutura GUID que identifica o tipo de objeto filho que pode herdar o ACE. A herança também é controlada pelos sinalizadores de herança no ACE_HEADER, bem como por qualquer proteção contra a herança colocada nos objetos filho.

O deslocamento desse membro pode variar. Se o Flags membro não contiver o sinalizador ACE_OBJECT_TYPE_PRESENT, o membro InheritedObjectType será iniciado no deslocamento especificado pelo membro ObjectType .

SidStart

Especifica o primeiro DWORD de um SID que identifica o de confiança a quem os direitos de acesso são concedidos. Os bytes restantes do SID são armazenados na memória contígua após o membro do SidStart. Esse SID pode ser acrescentado aos dados do aplicativo.

O deslocamento desse membro pode variar. Se o Flags membro for zero, o membro sidstart será iniciado no deslocamento especificado pelo membro ObjectType. Se Flags contiver apenas um sinalizador (ACE_OBJECT_TYPE_PRESENT ou ACE_INHERITED_OBJECT_TYPE_PRESENT), o membro sidstart será iniciado no deslocamento especificado pelo membro InheritedObjectType.

Observações

Se nem o ObjectType nem GUID deInheritedObjectType for especificado, a estrutura ACCESS_ALLOWED_OBJECT_ACE terá a mesma semântica usada pela estrutura ACCESS_ALLOWED_ACE. Nesse caso, use a estrutura ACCESS_ALLOWED_ACE porque ela é menor e mais eficiente.

Uma ACL que contém um ACCESS_ALLOWED_OBJECT_ACE deve especificar o número de revisão ACL_REVISION_DS em seu cabeçalho ACL .

Os direitos de acesso especificados pelo membro do Mask são concedidos a qualquer de administrador que possua um SID habilitado que corresponda ao SID armazenado no membro sidstart .

Uma estrutura de ACCESS_ALLOWED_OBJECT_ACE pode ser criada em uma ACL (lista de controle de acesso) por uma chamada para a função AddAccessAllowedObjectAce. Quando essa função é usada, a quantidade correta de memória necessária para acomodar as estruturas GUID no ObjectType e inheritedObjectType membros, se houver um ou ambos, bem como para acomodar o SID do administrador é alocado automaticamente. Além disso, os valores dos membros Header.AceType e Header.AceSize são definidos automaticamente. Quando uma estrutura ACCESS_ALLOWED_OBJECT_ACE é criada fora de uma ACL, a memória suficiente deve ser alocada para acomodar as estruturas GUID no ObjectType e membros InheritedObjectType, se houver um ou ambos, bem como para acomodar o SID completo do curador no membro sidStart e a memória contígua que o segue. Além disso, os valores dos membros Header.AceType e Header.AceSize devem ser definidos explicitamente pelo aplicativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	winnt.h (inclua Windows.h)

Consulte também

ACE

acl

AddAccessAllowedObjectAce

guid do

SID

Compartilhar via