estrutura OBJECTS_AND_NAME_A (accctrl.h)

Artigo
11/20/2024

A estrutura OBJECTS_AND_NAME contém uma cadeia de caracteres que identifica um administrador 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 valores a seguir.

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 o ACE se aplica.

Essa cadeia de caracteres deve ser uma LDAP válida nome de exibição 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 o ACE.

Essa cadeia de caracteres deve ser uma LDAP válida nome de exibição 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 a herança colocada nos objetos filho.

ptstrName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do administrador.

Observações

O ptstrName membro 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 do Trustee de uma estrutura EXPLICIT_ACCESS.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

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	accctrl.h