Freigeben über


OBJECTS_AND_NAME_A Struktur (accctrl.h)

Die OBJECTS_AND_NAME-Struktur enthält eine Zeichenfolge, die einen Truste anhand von Namen und zusätzlichen Zeichenfolgen identifiziert, die die Objekttypen eines objektspezifischen Zugriffssteuerungseintrags (ACE) identifizieren.

Syntax

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;

Angehörige

ObjectsPresent

Gibt an, ob die ObjectTypeName und InheritedObjectTypeName Elemente Zeichenfolgen enthalten. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

Wert Bedeutung
ACE_OBJECT_TYPE_PRESENT
0x1
Das element ObjectTypeName enthält eine Zeichenfolge.
ACE_INHERITED_OBJECT_TYPE_PRESENT
0x2
Der InheritedObjectTypeName Member enthält eine Zeichenfolge.

ObjectType

Gibt einen Wert aus der SE_OBJECT_TYPE-Aufzählung an, die den Objekttyp angibt.

ObjectTypeName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Typ des Objekts angibt, auf das die ACE angewendet wird.

Diese Zeichenfolge muss ein gültiger LDAP- Anzeigename im Active Directory-Schema sein.

InheritedObjectTypeName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Objekttyp identifiziert, der die ACE erben kann.

Diese Zeichenfolge muss ein gültiger LDAP- Anzeigename im Active Directory-Schema sein.

Wenn das ACE_INHERITED_OBJECT_TYPE_PRESENT Bit nicht im element ObjectsPresent festgelegt ist, wird das InheritedObjectTypeName Member ignoriert, und alle Typen untergeordneter Objekte können die ACE erben. Andernfalls kann nur der angegebene Objekttyp die ACE erben. In beiden Fällen wird die Vererbung auch durch die Vererbungskennzeichnungen in der ACE_HEADER-Struktur sowie durch jeden Schutz vor Vererbung gesteuert, die auf die untergeordneten Objekte gesetzt werden.

ptstrName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Trustees enthält.

Bemerkungen

Das ptstrName Member einer TRUSTEE--Struktur kann ein Zeiger auf eine OBJECTS_AND_NAME-Struktur sein. Dadurch können Funktionen wie SetEntriesInAcl und GetExplicitEntriesFromAcl objektspezifische ACE-Informationen im Trustee- Member einer EXPLICIT_ACCESS Struktur speichern.

Anmerkung

Der accctrl.h-Header definiert OBJECTS_AND_NAME_ als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- accctrl.h

Siehe auch

ACE_HEADER

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

OBJECTS_AND_SID

SE_OBJECT_TYPE

SetEntriesInAcl-

TRUSTEE-