COPYFILE2_MESSAGE_ACTION列舉 (winbase.h)
CopyFile2ProgressRoutine 回呼函式傳回,指出暫止複製作業應該採取什麼動作。
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;
常數
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 旗標時 COPY_FILE_RESTARTABLE旗標是在 dwCopyFlags 中設定 的成員 COPYFILE2_EXTENDED_PARAMETERS 結構 傳遞至 CopyFile2 函式。 |
COPYFILE2_PROGRESS_QUIET 繼續複製作業,但不呼叫 CopyFile2ProgressRoutine 回呼函式 再次針對這項作業。 |
COPYFILE2_PROGRESS_PAUSE 暫停複製作業並寫入重新啟動標頭。 這個值與不相容 COPY_FILE_RESTARTABLEdwCopyFlags 成員的 旗標 COPYFILE2_EXTENDED_PARAMETERS 結構。 在大部分情況下, CopyFile2 呼叫將會失敗,而且 return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) 和 any部分複製的片段會保留完整 (,但用來繼續複製的標頭除外 operation 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) |