ChangeSecurityPermissions-Methode der Win32_CodecFile-Klasse
Die WMI-KlassenmethodeChangeSecurityPermissions ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Codecdatei. Wenn die logische Datei ein Verzeichnis ist, ist ChangeSecurityPermissions rekursiv und ändert die Sicherheitsberechtigungen aller Dateien und Unterverzeichnisse, die das Verzeichnis enthält. ChangeSecurityPermissions 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. Dieser Deskriptor enthält neue Sicherheitsberechtigungen für die instance von Win32_CodecFile.
-
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 (0x1))
-
Ändern Sie den Besitzer der logischen Datei.
-
CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2))
-
Ändern Sie die Gruppe der logischen Datei.
-
CHANGE_DACL_SECURITY_INFORMATION (4 (0x4))
-
Ändern Sie die daCL (Discretionary Access Control List) der logischen Datei.
-
CHANGE_SACL_SECURITY_INFORMATION (8 (0x8))
-
Ä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 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 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 |
|