estrutura OBJECTS_AND_NAME_A (accctrl.h)

Artigo
08/22/2023

A estrutura OBJECTS_AND_NAME contém uma cadeia de caracteres que identifica um objeto de confiança por nome e cadeias de caracteres adicionais que identificam os tipos de objeto de uma ACE ( entrada de controle de acesso ) específica do objeto.

Sintaxe

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

Membros

ObjectsPresent

Indica se os membros ObjectTypeName e InheritedObjectTypeName contêm cadeias de caracteres. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
ACE_OBJECT_TYPE_PRESENT 0x1	O membro ObjectTypeName contém uma cadeia de caracteres.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	O membro InheritedObjectTypeName contém uma cadeia de caracteres.

ObjectType

Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto.

ObjectTypeName

Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica o tipo de objeto ao qual a ACE se aplica.

Essa cadeia de caracteres deve ser um nome de exibição LDAP válido no esquema do Active Directory.

InheritedObjectTypeName

Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica o tipo de objeto que pode herdar a ACE.

Essa cadeia de caracteres deve ser um nome de exibição LDAP válido no esquema do Active Directory.

Se o bit ACE_INHERITED_OBJECT_TYPE_PRESENT não estiver definido no membro ObjectsPresent , o membro InheritedObjectTypeName 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.

ptstrName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do objeto de confiança.

Comentários

O membro ptstrName de uma estrutura TRUSTEE pode ser um ponteiro para uma estrutura OBJECTS_AND_NAME . 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 .

Observação

O cabeçalho accctrl.h define OBJECTS_AND_NAME_ como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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