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 + 4

Oder

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	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen

Win32_CodecFile