Share via

COPYFILE2_MESSAGE_ACTION 枚举 (winbase.h)

  • 项目

由 CopyFile2ProgressRoutine 回调函数返回，用于指示应对挂起的复制操作采取什么操作。

语法

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

常量

 
COPYFILE2_PROGRESS_CONTINUE
值： 0
继续复制操作。
COPYFILE2_PROGRESS_CANCEL
取消复制操作。 CopyFile2 调用将失败
并返回 HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) 和
将删除所有部分复制的片段。
COPYFILE2_PROGRESS_STOP
停止复制操作。 CopyFile2 调用将失败
并返回 HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) 和
任何部分复制的片段都将保持不变。 可以使用 重启操作
COPY_FILE_RESUME_FROM_PAUSE 仅 当
在dwCopyFlags 中设置了COPY_FILE_RESTARTABLE标志
的成员
COPYFILE2_EXTENDED_PARAMETERS 结构
传递给 CopyFile2 函数。
COPYFILE2_PROGRESS_QUIET
继续复制操作，但不调用
CopyFile2ProgressRoutine 回调函数
再次执行此操作。
COPYFILE2_PROGRESS_PAUSE
暂停复制操作并写入重启标头。 此值与
的dwCopyFlags 成员的COPY_FILE_RESTARTABLE标志
COPYFILE2_EXTENDED_PARAMETERS
结构。 在大多数情况下， CopyFile2 调用将失败，并且
返回 HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) 和 any
部分复制的片段将保持不变 (，但用于恢复复制的标头除外
操作 later.) 如果复制操作在处理暂停请求时完成，
CopyFile2 调用将成功完成，不会恢复
将写入标头。 处理此值后，将向
包含消息的 CopyFile2ProgressRoutine
在 中指定 COPYFILE2_CALLBACK_STREAM_FINISHED (4) 值
的类型 成员
COPYFILE2_MESSAGE 结构。 在回调具有
返回的 CopyFile2 将失败，并显示
HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED).

注解

若要编译使用此枚举的应用程序，请将 _WIN32_WINNT 宏定义为0x0601或更高版本。 有关详细信息，请参阅 使用 Windows 标头。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
标头 winbase.h (包括 Windows.h)

另请参阅

CopyFile2

CopyFile2ProgressRoutine

文件管理枚举