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

Weitere Informationen

Betriebssystemklassen

_Win32-Verzeichnis