enumerazione COPYFILE2_MESSAGE_ACTION (winbase.h)

Articolo
03/13/2024

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

Condividi tramite