Share via

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)

另請參閱

CopyFile2

CopyFile2ProgressRoutine

檔案管理列舉