Metodo TakeOwnerShipEx della classe Win32_ShortcutFile
Il metodo della classe WMITakeOwnerShipEx ottiene la proprietà del file di collegamento logico 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, assumendo la proprietà di tutti i file e delle sottodirectory contenute nella directory.
In questo argomento viene utilizzata 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 sarà 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.
-
Ricorsiva [in, facoltativo]
-
Se true, la modifica della proprietà verrà applicata in modo ricorsivo a file e directory all'interno della directory specificata dall'istanza di CIM_LogicalFile .
Nota
Per le istanze di file, il parametro Ricorsivo viene ignorato.
Valore restituito
Restituisce un valore pari a 0 (zero) sull'esito positivo e qualsiasi altro numero per indicare un errore.
-
0
-
La richiesta è stata completata.
-
2
-
Accesso 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
-
Si è verificata una violazione di condivisione.
-
16
-
Il file iniziale specificato non è valido.
-
17
-
Non viene mantenuto un privilegio necessario per l'operazione.
-
21
-
Un parametro specificato non è valido.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|