Compartilhar via

estrutura OBJECTS_AND_NAME_W (accctrl.h)

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_W {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPWSTR         ObjectTypeName;
  LPWSTR         InheritedObjectTypeName;
  LPWSTR         ptstrName;
} OBJECTS_AND_NAME_W, *POBJECTS_AND_NAME_W;

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.

Se o bit ACE_INHERITED_OBJECT_TYPE_PRESENT não estiver definido no membro ObjectsPresent , o membro ObjectTypeName será ignorado.

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 membro ptstrName de uma estrutura TRUSTEE_W será um ponteiro para uma estrutura OBJECTS_AND_NAME_W se o TrusteeForm for TRUSTEE_IS_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

Consulte também

ACE_HEADER

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

OBJECTS_AND_SID

SE_OBJECT_TYPE

SetEntriesInAcl

TRUSTEE_W

  • Last updated on