GetEffectivePermission-Methode der CIM_DeviceFile-Klasse

Die GetEffectivePermission-Methode bestimmt, ob der Aufrufer über die aggregierten Berechtigungen für das CIM_DeviceFile-Objekt und die Freigabe verfügt, auf der sich die Datei oder das Verzeichnis befindet, wie durch das Permission-Argument angegeben. Diese Methode wird von CIM_LogicalFile geerbt.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

boolean GetEffectivePermission(
  [in] uint32 Permissions
);

Parameter

Berechtigungen [in]

Liste der Berechtigungen, die der Aufrufer abfragen kann.

FILE_READ_DATA (Datei) FILE_LIST_DIRECTORY (Verzeichnis) (1 (0x1))

Gewährt das Recht, Daten aus der Datei zu lesen. Für ein Verzeichnis gewährt dieser Wert das Recht, den Inhalt des Verzeichnisses auflisten zu können.

FILE_WRITE_DATA (Datei) FILE_ADD_FILE (Verzeichnis) (2 (0x2))

Gewährt das Recht, Daten in die Datei zu schreiben. Für ein Verzeichnis gewährt dieser Wert das Recht, eine Datei im Verzeichnis zu erstellen.

FILE_APPEND_DATA (Datei) FILE_ADD_SUBDIRECTORY (Verzeichnis) (4 (0x4))

Gewährt das Recht, Daten an die Datei anzufügen. Für ein Verzeichnis gewährt dieser Wert das Recht, ein Unterverzeichnis zu erstellen.

FILE_READ_EA (8 (0x8))

Gewährt das Recht, erweiterte Attribute zu lesen.

FILE_WRITE_EA (16 (0x10))

Gewährt das Recht, erweiterte Attribute zu schreiben.

FILE_EXECUTE (Datei) FILE_TRAVERSE (Verzeichnis) (32 (0x20))

Gewährt das Recht, eine Datei auszuführen. Für ein Verzeichnis kann das Verzeichnis durchlaufen werden.

FILE_DELETE_CHILD (Verzeichnis) (64 (0x40))

Gewährt das Recht, ein Verzeichnis und alle darin enthaltenen Dateien zu löschen, auch wenn die Dateien schreibgeschützt sind.

FILE_READ_ATTRIBUTES (128 (0x80))

Gewährt das Recht zum Lesen von Dateiattributen.

FILE_WRITE_ATTRIBUTES (256 (0x100))

Gewährt das Recht, Dateiattribute zu ändern.

DELETE (65536 (0x10000))

Gewährt Löschzugriff.

READ_CONTROL (131072 (0x20000))

Gewährt lesezugriff auf den Sicherheitsdeskriptor und den Besitzer.

WRITE_DAC (262144 (0x40000))

Gewährt Schreibzugriff auf die ermessensbezogene ACL.

WRITE_OWNER (524288 (0x80000))

Weist den Schreibbesitzer zu.

SYNCHRONIZE (1048576 (0x100000))

Synchronisiert den Zugriff und ermöglicht es einem Prozess, darauf zu warten, dass ein Objekt in den signalierten Zustand wechselt.

Rückgabewert

Gibt True zurück, wenn der Aufruf über die erforderliche Berechtigung verfügt. Andernfalls wird True zurückgegeben.

Bemerkungen

Diese Methode wird derzeit nicht von WMI implementiert. Um diese Methode verwenden zu können, müssen Sie sie in Ihrem eigenen Anbieter implementieren.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
Header	Aclui.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_DeviceFile

CIM_DeviceFile