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 の呼び出しは失敗し、 return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) と any部分的にコピーされたフラグメントはそのまま残ります (コピーの再開に使用されるヘッダーを除く) 操作は後で行います。 一時停止要求が処理された時点でコピー操作が完了した場合、 CopyFile2 呼び出しは正常に完了し、再開は完了しません ヘッダーが書き込まれます。 この値が処理された後、もう 1 つのコールバックが に対して行われます。 メッセージを含む 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 アプリ] |
| Header | winbase.h (Windows.h を含む) |