enumerazione COPYFILE2_MESSAGE_ACTION (winbase.h)

Restituito dalla funzione di callback CopyFile2ProgressRoutine per indicare quale azione deve essere eseguita per l'operazione di copia in sospeso.

Sintassi

typedef enum _COPYFILE2_MESSAGE_ACTION {
  COPYFILE2_PROGRESS_CONTINUE = 0,
  COPYFILE2_PROGRESS_CANCEL,
  COPYFILE2_PROGRESS_STOP,
  COPYFILE2_PROGRESS_QUIET,
  COPYFILE2_PROGRESS_PAUSE
} COPYFILE2_MESSAGE_ACTION;

Costanti

 
COPYFILE2_PROGRESS_CONTINUE
Valore: 0
Continuare l'operazione di copia.
COPYFILE2_PROGRESS_CANCEL
Annullare l'operazione di copia. La chiamata CopyFile2 avrà esito negativo
e restituire HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) e
tutti i frammenti parzialmente copiati verranno eliminati.
COPYFILE2_PROGRESS_STOP
Arrestare l'operazione di copia. La chiamata CopyFile2 avrà esito negativo
e restituire HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) e
tutti i frammenti parzialmente copiati verranno lasciati intatti. L'operazione può essere riavviata usando
COPY_FILE_RESUME_FROM_PAUSE flag solo se
COPY_FILE_RESTARTABLE flag è stato impostato in dwCopyFlags
membro dell'oggetto
struttura COPYFILE2_EXTENDED_PARAMETERS
passato alla funzione CopyFile2 .
COPYFILE2_PROGRESS_QUIET
Continuare l'operazione di copia, ma non chiamare
Funzione di callback CopyFile2ProgressRoutine
di nuovo per questa operazione.
COPYFILE2_PROGRESS_PAUSE
Sospendere l'operazione di copia e scrivere un'intestazione di riavvio. Questo valore non è compatibile con l'oggetto
COPY_FILE_RESTARTABLE flag per il membro dwCopyFlags di
COPYFILE2_EXTENDED_PARAMETERS
Struttura. Nella maggior parte dei casi la chiamata CopyFile2 avrà esito negativo e
restituisce HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) e qualsiasi
i frammenti parzialmente copiati verranno lasciati intatti( ad eccezione dell'intestazione scritta per riprendere la copia
operazione successiva. Se l'operazione di copia è stata completata al momento dell'elaborazione della richiesta di sospensione
La chiamata CopyFile2 verrà completata correttamente e non verrà ripresa
l'intestazione verrà scritta. Dopo l'elaborazione di questo valore, verrà eseguito un callback maggiore al
CopyFile2ProgressRoutine con il messaggio
specifica di un valore COPYFILE2_CALLBACK_STREAM_FINISHED (4) nell'oggetto
Membro del tipo dell'oggetto
COPYFILE2_MESSAGE struttura. Dopo che il callback ha
CopyFile2 restituito avrà esito negativo con
HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED).

Commenti

Per compilare un'applicazione che usa questa enumerazione, definire la macro _WIN32_WINNT come 0x0601 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Intestazione winbase.h (include Windows.h)

Vedi anche

CopyFile2

CopyFile2ProgressRoutine

Enumerazioni gestione file