TakeOwnerShipEx-Methode der Win32_Directory Klasse

Die TakeOwnerShipExWMI-Klassenmethode ruft den Besitz der im Objektpfad angegebenen logischen Verzeichniseintragsdatei ab. Diese Methode ist eine erweiterte Version der TakeOwnerShip-Methode . Wenn die logische Datei tatsächlich ein Verzeichnis ist, fungiert diese Methode rekursiv, indem Sie alle Dateien und Unterverzeichnisse übernehmen, die das Verzeichnis enthält.

In diesem Thema wird die Syntax "Managed Object Format" (MOF) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parameter

StopFileName [out]

Name der Datei oder des Verzeichnisses, in dem die TakeOwnerShipEx-Methode fehlgeschlagen ist. Dieser Parameter ist NULL , wenn die Methode erfolgreich ist.

StartFileName [in, optional]

Benannt die untergeordnete Datei oder das untergeordnete Verzeichnis, das als Ausgangspunkt für TakeOwnerShipEx verwendet werden soll. Der StartFileName-Parameter ist in der Regel der StopFileName-Parameter , der die Datei oder das Verzeichnis angibt, bei dem ein Fehler aus dem vorherigen Methodenaufruf aufgetreten ist. Wenn dieser Parameter NULL ist, wird der Vorgang auf der Datei oder dem verzeichnis ausgeführt, das im ExecMethod-Aufruf angegeben ist.

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

Rekursiv [in, optional]

Wenn True, wird die Änderung des Besitzes rekursiv auf Dateien und Verzeichnisse innerhalb des von der CIM_LogicalFile Instanz angegebenen Verzeichnisses angewendet.

Hinweis

Für Dateiinstanzen wird der Rekursive Eingabeparameter ignoriert.

Rückgabewert

Gibt einen ganzzahligen Wert von 0 (Null) auf Erfolg zurück, und jede andere Zahl, um einen Fehler anzugeben.

0

Die Anforderung wurde erfolgreich gesendet.

2

Access wurde verweigert.

8

Ein nicht angegebener Fehler ist aufgetreten.

9

Der angegebene Name war ungültig.

10

Das angegebene Objekt ist bereits vorhanden.

11

Das Dateisystem ist nicht NTFS.

12

Die Plattform ist nicht Windows.

13

Das Laufwerk ist nicht identisch.

14

Das Verzeichnis ist nicht leer.

15

Es gab eine Freigabeverletzung.

16

Die angegebene Startdatei war ungültig.

17

Ein für den Vorgang erforderliches Recht wird nicht gehalten.

21

Ein angegebener Parameter ist ungültig.

Beispiele

Der folgende Visual Basic Skriptcode ruft die TakeOwnerShipEx-Methode auf, um den Besitz des C:\temp-Ordners zu übernehmen.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx").inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod("Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Betriebssystemklassen

Win32_Directory