ChangeSecurityPermissions-Methode der Win32 _ Directory-Klasse
Die WMI-Klassenmethode ChangeSecurityPermissions ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Verzeichniseintragsdatei. Wenn die logische Datei ein Verzeichnis ist, 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 anzugeben.
In diesem Thema wird die 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 Instanz von Win32 _ SecurityDescriptoraufgelöst wird. Dieser Deskriptor enthält neue Sicherheitsberechtigungen für die Instanz von Win32 _ PageFile.
-
Option [ In]
-
Zu ändernde Sicherheitsberechtigungen. Verwenden Sie beispielsweise Folgendes, um die Sicherheit der Besitzer- und der Dacl-Zugriffssteuerungsliste (Discretionary Access Control List, DACL) zu ändern:
Option = 1 + 4Oder
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE _ _ _ BESITZERSICHERHEITSINFORMATIONEN (1)
-
Ändern Sie den Besitzer der logischen Datei.
-
CHANGE _ _ _ GRUPPENSICHERHEITSINFORMATIONEN (2)
-
Ändern Sie die Gruppe der logischen Datei.
-
CHANGE _ _DACL-SICHERHEITSINFORMATIONEN _ (4)
-
Ändern Sie die DACL der logischen Datei.
-
CHANGE _ _SACL-SICHERHEITSINFORMATIONEN _ (8)
-
Ändern Sie die Systemzugriffssteuerungsliste (SACL) der logischen Datei.
Rückgabewert
Gibt den Wert 0 (null) zurück, wenn die Berechtigungen geändert werden, und eine andere Zahl, um einen Fehler anzugeben.
-
Erfolgreich
-
0
Die Anforderung ist erfolgreich.
-
Zugriff verweigert
-
2
Zugriff verweigert.“
-
Nicht angegebener Fehler
-
8
Es ist ein nicht angegebener Fehler aufgetreten.
-
Ungültiges Objekt
-
9
Der angegebene Name ist ungültig.
-
Objekt ist 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 identisch
-
13
Das Laufwerk ist nicht identisch.
-
Verzeichnis nicht leer
-
14
Das Verzeichnis ist nicht leer.
-
Verletzung der Freigabe
-
15
Es liegt ein Freigabeverstoß vor.
-
Ungültige Startdatei
-
16
Die angegebene Startdatei ist ungültig.
-
Berechtigung nicht gehalten
-
17
Für den Vorgang ist keine Berechtigung erforderlich.
-
Ungültiger Parameter
-
21
Ein angegebener Parameter ist ungültig.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|