OBJECTS_AND_NAME_A-Struktur (accctrl.h)

Artikel
08/22/2023

Die OBJECTS_AND_NAME-Struktur enthält eine Zeichenfolge, die einen Vertrauenshänder anhand des Namens identifiziert, und zusätzliche Zeichenfolgen, die die Objekttypen eines objektspezifischen Zugriffssteuerungseintrags (Access Control Entry , 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;

Member

ObjectsPresent

Gibt an, ob die Member ObjectTypeName und InheritedObjectTypeName Zeichenfolgen enthalten. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
ACE_OBJECT_TYPE_PRESENT 0x1	Das ObjectTypeName-Element enthält eine Zeichenfolge.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Das InheritedObjectTypeName-Element enthält eine Zeichenfolge.

ObjectType

Gibt einen Wert aus der SE_OBJECT_TYPE-Enumeration an, der den Typ des Objekts angibt.

ObjectTypeName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Objekttyp identifiziert, auf den der ACE angewendet wird.

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

InheritedObjectTypeName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Typ des Objekts identifiziert, das den ACE erben kann.

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

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

ptstrName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Treuhänders enthält.

Hinweise

Das ptstrName-Element 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.

Hinweis

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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	accctrl.h