ACTRL_ACCESS_ENTRYA Struktur (accctrl.h)

Artikel
11/20/2024

Enthält Zugriffssteuerungsinformationen für einen angegebenen Trustee. Diese Struktur speichert Informationen, die den in einer ACE-gespeicherten Zugriffssteuerungsinformationen entsprechen.

Syntax

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Angehörige

Trustee

Eine TRUSTEE- Struktur, die den Benutzer, die Gruppe oder das Programm (z. B. einen Dienst) identifiziert, für den der Zugriffssteuerungseintrag gilt.

fAccessFlags

Gibt an, wie die von der Access- angegebenen Zugriffsrechte und ProvSpecificAccess--Member für den Trustee gelten. Dieses Element kann einer der folgenden Werte sein: Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControlverwenden, muss dieses Element ACTRL_ACCESS_ALLOWED oder ACTRL_ACCESS_DENIED sein.

Wert	Bedeutung
ACTRL_ACCESS_ALLOWED 0x00000001	Die Rechte sind zulässig.
ACTRL_ACCESS_DENIED 0x00000002	Die Rechte werden verweigert.
ACTRL_AUDIT_SUCCESS 0x00000004	Das System generiert Überwachungsmeldungen für fehlgeschlagene Versuche, die Rechte zu verwenden.
ACTRL_AUDIT_FAILURE 0x00000008	Das System generiert Überwachungsmeldungen für erfolgreiche Versuche, die Rechte zu verwenden.

Access

Eine Bitmaske, die die Zugriffsrechte angibt, die der Eintrag für den Trustee zulässt, verweigert oder überwacht.

Dieses Mitglied muss die anbieterunabhängigen Zugriffskennzeichnungen wie ACTRL_READ_CONTROL anstelle von Zugriffskennzeichnungen wie READ_CONTROL verwenden. Der Anbieter für den Objekttyp konvertiert diese anbieterunabhängigen Flags in die entsprechenden anbieterspezifischen Flags.

Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControlverwenden, muss dieses Element COM_RIGHTS_EXECUTE werden.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Eine Bitmaske, die Zugriffsberechtigungen angibt, die für den Anbietertyp spezifisch sind. Die Funktionen, die die ACTRL_ACCESS_ENTRY Struktur verwenden, übergeben diese Bits an den Anbieter, ohne sie zu interpretieren. In den meisten Fällen sollte dieses Mitglied 0 sein.

Inheritance

Eine Gruppe von Bitkennzeichnungen, die bestimmt, ob andere Container oder Objekte den Zugriffssteuerungseintrag vom primären Objekt erben können, an das die Zugriffsliste angefügt ist. Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControlverwenden, muss dieser Wert NO_INHERITANCE sein, was angibt, dass der Zugriffssteuerungseintrag nicht vererbbar ist. Andernfalls kann dieser Wert NO_INHERITANCE oder eine Kombination der folgenden Werte sein.

Wert	Bedeutung
CONTAINER_INHERIT_ACE 0x2	Andere Container, die im primären Objekt enthalten sind, erben den Eintrag.
INHERIT_ONLY_ACE 0x8	Die ACE gilt nicht für das primäre Objekt, an das die ACL angefügt ist, sondern objekte, die vom primären Objekt enthalten sind, erben den Eintrag.
NO_PROPAGATE_INHERIT_ACE 0x4	Die flags OBJECT_INHERIT_ACE und CONTAINER_INHERIT_ACE werden nicht an einen geerbten Eintrag weitergegeben.
OBJECT_INHERIT_ACE 0x1	Nichtcontainerobjekte, die im primären Objekt enthalten sind, erben den Eintrag.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Sowohl Container als auch Nichtcontainerobjekte, die im primären Objekt enthalten sind, erben den Eintrag. Diese Kennzeichnung entspricht der Kombination der CONTAINER_INHERIT_ACE und OBJECT_INHERIT_ACE Flags.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Andere Container, die im primären Objekt enthalten sind, erben den Eintrag. Dieses Kennzeichen entspricht der CONTAINER_INHERIT_ACE Kennzeichnung.
SUB_OBJECTS_ONLY_INHERIT 0x1	Nichtcontainerobjekte, die im primären Objekt enthalten sind, erben den Eintrag. Diese Kennzeichnung entspricht der OBJECT_INHERIT_ACE Kennzeichnung.

lpInheritProperty

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die die Objekttypen identifiziert, die den Eintrag erben können. Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControlverwenden, muss dieses Element NULL-sein.

Bemerkungen

Anmerkung

Der accctrl.h-Header definiert ACTRL_ACCESS_ENTRY 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 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	accctrl.h

Siehe auch

ACTRL_ACCESS_ENTRY_LIST

TRUSTEE-

Freigeben über