Metodo TakeOwnerShipEx della classe Win32_Directory

Articolo
06/12/2023

Il metodo della classe WMITakeOwnerShipEx ottiene la proprietà del file di immissione della directory logica specificato nel percorso dell'oggetto. Questo metodo è una versione estesa del metodo TakeOwnerShip . Se il file logico è effettivamente una directory, questo metodo agisce in modo ricorsivo, prendendo la proprietà di tutti i file e le sottodirectory che la directory contiene.

Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.

Sintassi

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

Parametri

StopFileName [out]

Nome del file o della directory in cui il metodo TakeOwnerShipEx non è riuscito. Questo parametro è NULL se il metodo ha esito positivo.

StartFileName [in, facoltativo]

Assegna un nome al file figlio o alla directory da usare come punto di partenza per TakeOwnerShipEx. Il parametro StartFileName è in genere il parametro StopFileName che specifica il file o la directory in cui si è verificato un errore dalla chiamata al metodo precedente. Se questo parametro è NULL, l'operazione viene eseguita nel file o nella directory specificata nella chiamata ExecMethod .

Se viene usato StartFileName, è necessario impostare anche su true.

Ricorsivo [in, facoltativo]

Se True, la modifica della proprietà viene applicata in modo ricorsivo ai file e alle directory all'interno della directory specificata dall'istanza di CIM_LogicalFile .

Nota

Per le istanze di file, il parametro di input ricorsivo viene ignorato.

Valore restituito

Restituisce un valore intero pari a 0 (zero) sull'esito positivo e su qualsiasi altro numero per indicare un errore.

0: La richiesta è stata completata.
2: L'accesso è stato negato.
8: Si è verificato un errore non specificato.
9: Il nome specificato non è valido.
10: L'oggetto specificato esiste già.
11: Il file system non è NTFS.
12: La piattaforma non è Windows.
13: L'unità non è la stessa.
14: La directory non è vuota.
15: C'è stata una violazione della condivisione.
16: Il file di avvio specificato non è valido.
17: Non viene mantenuto un privilegio necessario per l'operazione.
21: Un parametro specificato non è valido.

Esempio

Il codice script di Visual Basic seguente chiama il metodo TakeOwnerShipEx per acquisire la proprietà della cartella C:\temp.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Radice\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo
Win32_Directory