Metodo TakeOwnerShipEx della classe CIM_DataFile
Il metodo TakeOwnerShipEx ottiene la proprietà del file di dati logico specificato nel percorso dell'oggetto. Questo metodo è una versione estesa del metodo TakeOwnerShip e viene ereditato da CIM_LogicalFile. Se il file logico è una directory, questo metodo agisce in modo ricorsivo, acquisendo la proprietà di tutti i file e delle sottodirectory contenute nella directory.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.
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] string StartFileName,
[in] boolean Recursive
);
Parametri
-
StopFileName [out]
-
Nome del file (o directory) in cui il metodo non è riuscito. Questo parametro sarà Null se il metodo ha esito positivo.
-
StartFileName [in]
-
File figlio (o directory) da usare come punto di partenza per questo metodo. In genere, il parametro StartFileName è 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 a ExecMethod .
Se si usa StartFileName , è necessario impostare anche Recursive su true.
-
Ricorsiva [in]
-
Se TRUE, il metodo viene applicato in modo ricorsivo anche a file e directory all'interno della directory specificata dall'istanza di CIM_DataFile . Per le istanze di file, questo parametro viene ignorato.
Valore restituito
Restituisce un valore pari a 0 (zero) sull'esito positivo e qualsiasi altro numero per indicare un errore. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.
-
0
-
Operazione completata.
-
2
-
Accesso negato.
-
8
-
Errore non specificato.
-
9
-
Oggetto non valido.
-
10
-
Oggetto già esistente.
-
11
-
File system non NTFS.
-
12
-
Piattaforma non Windows.
-
13
-
L'unità non è la stessa.
-
14
-
Directory non vuota.
-
15
-
Violazione di condivisione.
-
16
-
File di avvio non valido.
-
17
-
Privilegio non mantenuto.
-
21
-
Parametro non valido.
Commenti
Il metodo TakeOwnerShipEx in CIM_DataFile viene implementato da WMI.
Questa documentazione è derivata dalle descrizioni delle classi CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, essere conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|