estrutura OBJECTS_AND_SID (accctrl.h)

Artigo
02/23/2024

A estrutura OBJECTS_AND_SID contém um SID ( identificador de segurança ) que identifica um objeto de confiança e GUIDs que identificam os tipos de objeto de uma ACE ( entrada de controle de acesso ) específica do objeto.

Sintaxe

typedef struct _OBJECTS_AND_SID {
  DWORD ObjectsPresent;
  GUID  ObjectTypeGuid;
  GUID  InheritedObjectTypeGuid;
  SID   *pSid;
} OBJECTS_AND_SID, *POBJECTS_AND_SID;

Membros

ObjectsPresent

Indica se os membros ObjectTypeGuid e InheritedObjectTypeGuid contêm GUIDs. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
ACE_OBJECT_TYPE_PRESENT 0x1	O membro ObjectTypeGuid contém um GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	O membro InheritedObjectTypeGuid contém um GUID.

ObjectTypeGuid

Uma estrutura GUID que identifica o tipo de objeto, conjunto de propriedades ou propriedade protegida pelo ACE. Se essa ACE for herdada, o GUID identificará o tipo de objeto, conjunto de propriedades ou propriedade protegido pelo ACE herdado. Esse GUID deve ser um identificador de esquema válido no esquema do Active Directory.

Se o bit ACE_OBJECT_TYPE_PRESENT não estiver definido no membro ObjectsPresent , o membro ObjectTypeGuid será ignorado e o ACE protegerá o objeto ao qual a ACL é atribuída.

InheritedObjectTypeGuid

Uma estrutura GUID que identifica o tipo de objeto que pode herdar o ACE. Esse GUID deve ser um identificador de esquema válido no esquema do Active Directory.

Se o bit ACE_INHERITED_OBJECT_TYPE_PRESENT não estiver definido no membro ObjectsPresent , o membro InheritedObjectTypeGuid será ignorado e todos os tipos de objetos filho poderão herdar o ACE. Caso contrário, somente o tipo de objeto especificado poderá herdar o ACE. Em ambos os casos, a herança também é controlada pelos sinalizadores de herança na estrutura ACE_HEADER , bem como por qualquer proteção contra herança colocada nos objetos filho.

pSid

Um ponteiro para o SID do objeto de confiança ao qual a ACE se aplica.

Comentários

O membro ptstrName de uma estrutura TRUSTEE pode ser um ponteiro para uma estrutura OBJECTS_AND_SID . Isso permite que funções como SetEntriesInAcl e GetExplicitEntriesFromAcl armazenem informações ace específicas do objeto no membro De confiança de uma estrutura EXPLICIT_ACCESS .

Quando você usa essa estrutura em uma chamada para SetEntriesInAcl, ObjectTypeGuid e InheritedObjectTypeGuid devem ser identificadores de esquema válidos no esquema do Active Directory. O sistema não verifica os GUIDs; eles são usados como estão.

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]
Cabeçalho	accctrl.h