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) |