Freigeben über


ChangeSecurityPermissions-Methode der Win32_Directory-Klasse

Die WMI-Klassemethode ChangeSecurityPermissions ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene Eintragsdatei des logischen Verzeichnisses. Wenn es sich bei der logischen Datei um ein Verzeichnis handelt, 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 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. Diese Beschreibung enthält neue Sicherheitsberechtigungen für die instance von Win32_PageFile.

Option [in]

Zu ändernde Sicherheitsberechtigungen. 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)

Ändern Sie den Besitzer der logischen Datei.

CHANGE_GROUP_SECURITY_INFORMATION (2)

Ändern Sie die Gruppe der logischen Datei.

CHANGE_DACL_SECURITY_INFORMATION (4)

Ändern Sie die diskretionäre DACL der logischen Datei.

CHANGE_SACL_SECURITY_INFORMATION (8)

Ändern Sie die Systemzugriffssteuerungsliste (System Access Control List, 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 spezifizierter 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.

Freigabeverletzung

15

Es liegt ein Verstoß gegen die Freigabe vor.

Ungültige Startdatei

16

Die angegebene Startdatei ist ungültig.

Nicht gehaltene Berechtigung

17

Ein für den Vorgang erforderliches Recht 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_Directory