ChangeSecurityPermissionsEx-Methode der Win32_PageFile-Klasse
Die WMI-KlassenmethodeChangeSecurityPermissionsEx ändert die Sicherheitsberechtigungen für die logische Auslagerungsdatei, die im Objektpfad angegeben ist (diese Methode ist eine erweiterte Version der ChangeSecurityPermissions-Methode). Wenn die logische Datei ein Verzeichnis ist, ist diese Methode rekursiv und ändert die Sicherheitsberechtigungen aller Dateien und Unterverzeichnisse, die das Verzeichnis enthält.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parameter
-
SecurityDescriptor [in]
-
Ausdruck, der in eine instance von Win32_SecurityDescriptor aufgelöst wird. Dieser Parameter 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 DACL der logischen Datei.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Ändern Sie die SACL-Liste (System Access Control) der logischen Datei.
StopFileName [out]
Name der Datei oder des Verzeichnisses, in der die ChangeSecurityPermissionsEx-Methode fehlgeschlagen ist. Dieser Parameter ist NULL , wenn die Methode erfolgreich ist.
StartFileName [in, optional]
Benennt die untergeordnete Datei oder das untergeordnete Verzeichnis, das als Ausgangspunkt für ChangeSecurityPermissionsEx verwendet werden soll. In der Regel ist der StartFileName-Parameter der StartFileName-Parameter , der die Datei oder das Verzeichnis angibt, in der ein Fehler aus dem vorherigen Methodenaufruf aufgetreten ist. Wenn dieser Parameter NULL ist, wird der Vorgang für die Im ExecMethod-Aufruf angegebene Datei oder das Verzeichnis ausgeführt.
Rekursiv [in, optional]
Wenn true, wird die Änderung des Besitzes rekursiv auf Dateien und Verzeichnisse in dem verzeichnis angewendet, das vom CIM_LogicalFile instance angegeben wird.
Hinweis
Bei Dateiinstanzen wird der Rekursive-Parameter ignoriert.
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 angegebener 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.
-
Verletzung der Freigabe
-
15
Es liegt ein Verstoß gegen die Freigabe vor.
-
Ungültige Startdatei
-
16
Die angegebene Startdatei ist ungültig.
-
Berechtigung nicht gehalten
-
17
Eine für den Vorgang erforderliche Berechtigung fehlt.
-
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 |
|