enumeración COPYFILE2_MESSAGE_ACTION (winbase.h)

  • Artículo

Devuelto por la función de devolución de llamada CopyFile2ProgressRoutine para indicar qué acción se debe realizar para la operación de copia pendiente.

Syntax

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

Constantes

 
COPYFILE2_PROGRESS_CONTINUE
Valor: 0
Continúe con la operación de copia.
COPYFILE2_PROGRESS_CANCEL
Cancele la operación de copia. Se producirá un error en la llamada a CopyFile2 .
y devuelven HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) y
se eliminarán los fragmentos parcialmente copiados.
COPYFILE2_PROGRESS_STOP
Detenga la operación de copia. Se producirá un error en la llamada a CopyFile2 .
y devuelven HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) y
los fragmentos parcialmente copiados se quedarán intactos. La operación se puede reiniciar mediante
COPY_FILE_RESUME_FROM_PAUSE marca solo si
COPY_FILE_RESTARTABLE marca se estableció en dwCopyFlags
miembro del
estructura de COPYFILE2_EXTENDED_PARAMETERS
se pasa a la función CopyFile2 .
COPYFILE2_PROGRESS_QUIET
Continúe con la operación de copia, pero no llame a
Función de devolución de llamada CopyFile2ProgressRoutine
de nuevo para esta operación.
COPYFILE2_PROGRESS_PAUSE
Pause la operación de copia y escriba un encabezado de reinicio. Este valor no es compatible con
COPY_FILE_RESTARTABLE marca para el miembro dwCopyFlags de
el COPYFILE2_EXTENDED_PARAMETERS
Estructura. En la mayoría de los casos, se producirá un error en la llamada a CopyFile2 y
return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) y any
los fragmentos parcialmente copiados se quedarán intactos (excepto el encabezado escrito que se usa para reanudar la copia.
operación posterior). En caso de que la operación de copia se haya completado en el momento en que se procesa la solicitud de pausa.
La llamada a CopyFile2 se completará correctamente y no se reanudará
se escribirá el encabezado. Después de procesar este valor, se realizará una devolución de llamada más en la
CopyFile2ProgressRoutine con el mensaje
especificar un valor de COPYFILE2_CALLBACK_STREAM_FINISHED (4) en
Miembro de tipo del
COPYFILE2_MESSAGE estructura. Después de que la devolución de llamada tenga
Se producirá un error en CopyFile2 devuelto con
HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED).

Comentarios

Para compilar una aplicación que use esta enumeración, defina la macro _WIN32_WINNT como 0x0601 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado winbase.h (incluya Windows.h)

Consulte también

CopyFile2

CopyFile2ProgressRoutine

Enumeraciones de administración de archivos