Metodo CopyEx della classe CIM _ DeviceFile

Il metodo CopyEx copia il file o la directory del dispositivo logico specificato nel percorso dell'oggetto nel percorso specificato dal parametro filename . Una copia non è supportata se è necessario sovrascrivere un file logico esistente. Questo metodo è una versione estesa del metodo Copy . Questo metodo viene ereditato da _ LogicalFile CIM.

Importante

Le classi CIM (Common Information Model) DMTF (Distributed Management Task Force) sono le classi padre sulle quali vengono compilate le classi WMI. Attualmente WMI supporta solo gli schemi della versione CIM 2. x.

In questo argomento viene utilizzata la sintassi Managed Object Format (MOF). Per ulteriori informazioni sull'utilizzo di questo metodo, vedere chiamata a un metodo.

Sintassi

uint32 CopyEx(
  [in]  string     FileName,
  [out] string REF StopFileName,
  [in]  string     StartFileName,
  [in]  boolean    Recursive
);

Parametri

Nome file [ in]

Nome completo del file di destinazione (o directory).

Esempio: "c: \ temp \ NewDirectory"

StopFileName [ out]

Stringa che rappresenta il nome del file o della directory in cui il metodo ha avuto esito negativo. Questo parametro è null se il metodo ha esito positivo.

StartFileName [ in]

Stringa che rappresenta il file o la directory figlio da utilizzare 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 sul file o sulla directory specificati nella chiamata ExecMethod .

Ricorsivo [ in]

Se è TRUE, anche il metodo viene applicato in modo ricorsivo a file e directory all'interno della directory specificata dall'istanza CIM _ DeviceFile . Per le istanze di file, questo parametro viene ignorato.

Valore restituito

Restituisce un valore pari a 0 (zero) in caso di esito positivo e qualsiasi altro numero per indicare un errore.

0

Esito positivo.

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

Questo metodo non è attualmente implementato da WMI. Per usare questo metodo, è necessario implementarlo nel proprio provider.

Questa documentazione è derivata dalle descrizioni della classe CIM pubblicate da DMTF. Microsoft potrebbe avere apportato modifiche per correggere gli errori secondari, rispettare gli standard di 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
\CIMV2 radice
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Vedi anche

_DEVICEFILE CIM

_DEVICEFILE CIM