ChangeSecurityPermissions-Methode der Win32_Directory-Klasse
Die WMI-Klassemethode ChangeSecurityPermissions ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene Eintragsdatei des logischen Verzeichnisses. Wenn es sich bei der logischen Datei um ein Verzeichnis handelt, ist ChangeSecurityPermissions rekursiv und ändert die Sicherheitsberechtigungen aller Dateien und Unterverzeichnisse, die das Verzeichnis enthält. Die ChangeSecurityPermissions-Klasse gibt einen ganzzahligen Wert von 0 (null) zurück, wenn die Berechtigungen geändert werden, und eine andere Zahl, um einen Fehler anzuzeigen.
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]
-
Ausdruck, der in eine instance von Win32_SecurityDescriptor aufgelöst wird. Diese Beschreibung enthält neue Sicherheitsberechtigungen für die instance von Win32_PageFile.
-
Option [in]
-
Zu ändernde Sicherheitsberechtigungen. Um beispielsweise die DACL-Sicherheit (Owner and Discretionary Access Control List) zu ändern, verwenden Sie Folgendes:
Option = 1 + 4Oder
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 diskretionäre DACL der logischen Datei.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Ändern Sie die Systemzugriffssteuerungsliste (System Access Control List, SACL) der logischen Datei.
Rückgabewert
Gibt den Wert 0 (null) zurück, wenn die Berechtigungen geändert werden, und eine andere Zahl, um auf einen Fehler hinzuweisen.
-
Erfolgreich
-
0
Die Anforderung ist erfolgreich.
-
Zugriff verweigert
-
2
Zugriff verweigert.“
-
Nicht spezifizierter Fehler
-
8
Ein nicht angegebener Fehler ist aufgetreten.
-
Ungültiges Objekt
-
9
Der angegebene Name ist ungültig.
-
Objekt bereits vorhanden
-
10
Das Objekt "" ist bereits vorhanden.
-
Dateisystem nicht NTFS
-
11
Das Dateisystem ist kein NTFS-Dateisystem.
-
Plattform nicht NT/Windows 2000
-
12
Die Plattform ist nicht Windows.
-
Laufwerk nicht gleich
-
13
Das Laufwerk ist nicht identisch.
-
Verzeichnis nicht leer
-
14
Das Verzeichnis ist nicht leer.
-
Freigabeverletzung
-
15
Es liegt ein Verstoß gegen die Freigabe vor.
-
Ungültige Startdatei
-
16
Die angegebene Startdatei ist ungültig.
-
Nicht gehaltene Berechtigung
-
17
Ein für den Vorgang erforderliches Recht wird nicht gehalten.
-
Ungültiger Parameter
-
21
Ein angegebener Parameter ist ungültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|