SI_ACCESS-Struktur (aclui.h)

Artikel
02/23/2024

Die SI_ACCESS-Struktur enthält Informationen zu einem Zugriffsrecht oder einer Standardzugriffsmaske für ein sicherungsfähiges Objekt. Die ISecurityInformation::GetAccessRights-Methode verwendet diese Struktur, um Informationen anzugeben, die der Zugriffssteuerungs-Editor zum Initialisieren seiner Eigenschaftenseiten verwendet.

Syntax

typedef struct _SI_ACCESS {
  const GUID  *pguid;
  ACCESS_MASK mask;
  LPCWSTR     pszName;
  DWORD       dwFlags;
} SI_ACCESS, *PSI_ACCESS;

Member

pguid

Ein Zeiger auf eine GUID-Struktur , die den Typ des Objekts identifiziert, für den das Zugriffsrecht oder die Standardzugriffsmaske gilt. Die GUID kann einen Eigenschaftssatz oder eine Eigenschaft für das Objekt oder einen Typ von untergeordneten Objekten identifizieren, die im Objekt enthalten sein können.

Wenn dieses Element auf GUID_NULL verweist, gilt das Zugriffsrecht für das Objekt selbst.

mask

Eine Bitmaske, die das von dieser Struktur beschriebene Zugriffsrecht angibt. Die Maske kann eine beliebige Kombination von Standard- und spezifischen Rechten enthalten, sollte aber keine generischen Rechte wie GENERIC_ALL enthalten.

pszName

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die eine Anzeigezeichenfolge enthält, die das Zugriffsrecht beschreibt.

Alternativ kann pszName ein Zeichenfolgenressourcenbezeichner sein, der vom MAKEINTRESOURCE-Makro zurückgegeben wird. Verwenden Sie die ISecurityInformation::GetObjectInformation-Methode , um das Modul zu identifizieren, das die Zeichenfolgenressource enthält.

dwFlags

Eine Reihe von Bitflags, die angeben, wo das Zugriffsrecht angezeigt wird. Bei diesem Member kann es sich um eine Kombination aus folgendem Element handelt.

Wert	Bedeutung
SI_ACCESS_SPECIFIC	Das Zugriffsrecht wird auf den erweiterten Sicherheitsseiten angezeigt.
SI_ACCESS_GENERAL	Das Zugriffsrecht wird auf der Seite "Grundlegende Sicherheit" angezeigt.
SI_ACCESS_CONTAINER	Gibt ein Zugriffsrecht an, das nur für Container gilt. Wenn dieses Flag festgelegt ist, wird das Zugriffsrecht nur auf der Seite "Grundlegende Sicherheit" angezeigt, wenn die ISecurityInformation::GetObjectInformation-Methode das SI_CONTAINER-Flag angibt.
SI_ACCESS_PROPERTY	Gibt ein eigenschaftsspezifisches Zugriffsrecht an. Wird mit SI_EDIT_PROPERTIES verwendet.

Dieses Member kann auch eine Kombination der folgenden Flags angeben, um anzugeben, ob andere Container oder Objekte das Zugriffsrecht erben können.

Wert	Bedeutung
CONTAINER_INHERIT_ACE	Andere Container, die im primären Objekt enthalten sind, erben den Eintrag.
INHERIT_ONLY_ACE	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.
OBJECT_INHERIT_ACE	Nichtcontainerobjekte, die vom primären Objekt enthalten sind, erben den Eintrag.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	aclui.h

Weitere Informationen

GUID

ISecurityInformation::GetAccessRights

ISecurityInformation::GetObjectInformation

Share via