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 |
|---|---|
|
Das ObjectTypeName-Element enthält eine Zeichenfolge. |
|
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 |