ChangeSecurityPermissionsEx-Methode der Win32 _ Directory-Klasse

Die WMI-Klassenmethode ChangeSecurityPermissionsEx ändert die Sicherheitsberechtigungen für die Verzeichniseintragsdatei, 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 die 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 Instanz von Win32 _ SecurityDescriptoraufgelöst wird. Dieser Parameter 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 + 4

Oder

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-Liste der logischen Datei.

CHANGE _ _SACL-SICHERHEITSINFORMATIONEN _ (8)

Ä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 Verzeichnis, die bzw. das als Ausgangspunkt für ChangeSecurityPermissionsEx verwendet werden soll. In der Regel ist der StartFileName-Parameter der StopFileName-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 Datei oder das Verzeichnis ausgeführt, die bzw. das im ExecMethod-Aufruf angegeben ist. Dieser Parameter ist optional.

Wenn StartFileName verwendet wird, muss Recursive auch auf TRUE festgelegt werden.

Rekursiv [ in, optional]

True gibt an, dass die Besitzänderung rekursiv auf Dateien und Verzeichnisse innerhalb des Verzeichnisses angewendet wird, das von der CIM _ LogicalFile-Instanz angegeben wird. Bei Dateiinstanzen wird der Rekursive Eingabeparameter ignoriert. Dieser Parameter ist optional.

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

Weitere Informationen

Betriebssystemklassen

_Win32-Verzeichnis