Freigeben über


OBJECTS_AND_NAME_A-Struktur (accctrl.h)

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

Weitere Informationen

ACE_HEADER

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

OBJECTS_AND_SID

SE_OBJECT_TYPE

SetEntriesInAcl

TREUHÄNDER