ChangeSecurityPermissions-Methode der CIM_DataFile-Klasse

Die ChangeSecurityPermissions-Methode ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Datendatei. Wenn es sich bei der logischen Datei um ein Verzeichnis handelt, handelt diese Methode rekursiv und ändert die Sicherheitsberechtigungen für alle Dateien und Unterverzeichnisse, die das Verzeichnis enthält. 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

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

Parameter

SecurityDescriptor [in]

Gibt die Sicherheitsinformationen an.

Hinweis

Eine NULL-Zugriffssteuerungsliste ( ACL ) in der SECURITY_DESCRIPTOR-Struktur gewährt unbegrenzten Zugriff. Informationen zu den Auswirkungen unbegrenzten Zugriffs finden Sie unter Erstellen eines Sicherheitsdeskriptors für ein neues Objekt.

Option [in]

Zu ändernde Sicherheitsberechtigungen. Verwenden Sie beispielsweise folgendes, um die Besitzer- und DACL-Sicherheit zu ändern:

Option = 1 + 4

oder

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

Ändern Sie den Besitzer der logischen Datei.

CHANGE_GROUP_SECURITY_INFORMATION (2)

Ändern Sie die Gruppe der logischen Datei.

CHANGE_DACL_SECURITY_INFORMATION (4)

Ändern Sie die ACL der logischen Datei.

CHANGE_SACL_SECURITY_INFORMATION (8)

Ändern Sie die System-ACL der logischen Datei.

Rückgabewert

Gibt bei Erfolg den Wert 0 und eine beliebige andere Zahl zurück, um auf einen Fehler hinzuweisen. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolgreich

0

Erfolg.

Zugriff verweigert

2

Zugriff verweigert.

Nicht spezifizierter Fehler

8

Nicht spezifizierter Fehler.

Ungültiges Objekt

9

Ungültiges Objekt.

Objekt bereits vorhanden

10

Das Objekt ist bereits vorhanden.

Dateisystem nicht NTFS

11

Plattform nicht NT/Windows 2000

12

Plattform, nicht Windows NT-basiert.

Laufwerk nicht gleich

13

Laufwerk nicht gleich.

Verzeichnis nicht leer

14

„Verzeichnis ist nicht leer.“

Freigabeverletzung

15

Freigabeverletzung.

Ungültige Startdatei

16

Ungültige Startdatei.

Nicht gehaltene Berechtigung

17

Berechtigung nicht gehalten.

Ungültiger Parameter

21

Ungültiger Parameter.

Bemerkungen

Die ChangeSecurityPermissions-Methode in CIM_DataFile wird von WMI implementiert.

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

Anforderungen

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

Siehe auch

CIM_DataFile

CIM_DataFile

WMI-Aufgaben: Dateien und Ordner

Datei- und Verzeichniszugriffsrechtkonstanten