ACTRL_ACCESS_ENTRYA-Struktur (accctrl.h)

Artikel
02/28/2024

Enthält Zugriffssteuerungsinformationen für einen angegebenen Treuhänder. Diese Struktur speichert Informationen, die den in einem 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;

Member

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 den Access - und ProvSpecificAccess-Membern angegebenen Zugriffsrechte auf den Treuhänder angewendet werden. Dieser Member kann einer der folgenden Werte sein. Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControl verwenden, 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 Treuhänder zulässt, verweigert oder überwacht.

Dieses Mitglied muss die anbieterunabhängigen Zugriffsflags verwenden, z. B. ACTRL_READ_CONTROL, anstelle von Zugriffsflags wie READ_CONTROL. 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 IAccessControl verwenden, muss dieses Element COM_RIGHTS_EXECUTE sein.

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 für den Anbietertyp spezifische Zugriffsrechte angibt. 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 dieser Member 0 sein.

Inheritance

Eine Reihe von Bitflags, die bestimmen, ob andere Container oder Objekte den Zugriffssteuerungseintrag vom primären Objekt erben können, dem die Zugriffsliste angefügt ist. Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControl verwenden, muss dieser Wert NO_INHERITANCE sein, was angibt, dass der Zugriffssteuerungseintrag nicht vererbt werden kann. 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	Der ACE gilt nicht für das primäre Objekt, an das die ACL angefügt ist, sondern objekte, die im 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 vom 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. Dieses Flag entspricht der Kombination aus 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 Flag entspricht dem CONTAINER_INHERIT_ACE-Flag.
SUB_OBJECTS_ONLY_INHERIT 0x1	Nichtcontainerobjekte, die vom primären Objekt enthalten sind, erben den Eintrag. Dieses Flag entspricht dem OBJECT_INHERIT_ACE Flag.

lpInheritProperty

Ein Zeiger auf eine NULL-Zeichenfolge, die die Objekttypen identifiziert, die den Eintrag erben können. Wenn Sie diese Struktur mit der COM-Implementierung von IAccessControl verwenden, muss dieser Member NULL sein.

Hinweise

Hinweis

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 nicht codierungsneutralem Code 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 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	accctrl.h

Weitere Informationen

ACTRL_ACCESS_ENTRY_LIST

TREUHÄNDER

Share via