ChangeSecurityPermissionsEx-Methode der Win32_CodecFile-Klasse
Die WMI-KlassenmethodeChangeSecurityPermissionsEx ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene Codecdatei (diese Methode ist eine erweiterte Version der ChangeSecurityPermissions-Methode). Wenn es sich bei der logischen Datei um ein Verzeichnis handelt, 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 Deskriptor enthält neue Sicherheitsberechtigungen für die instance von Win32_CodecFile.
-
Option [in]
-
Die tatsächliche Sicherheitsberechtigung, die geändert werden soll. 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.
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 Parameter StartFileName der Parameter StopFileName , 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, werden die Besitzeränderungen rekursiv auf Dateien und Verzeichnisse in dem Verzeichnis angewendet, das vom CIM_LogicalFile instance angegeben wird. Bei Dateiinstanzen wird der Rekursive-Eingabeparameter 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 NT oder Windows 2000.
-
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 |
|