ホーム › Storage.FileSystem › COPYFILE2_MESSAGE_ACTION

COPYFILE2_MESSAGE_ACTION

列挙型

基底型i4

メンバー 5

名前	10進	16進	説明
COPYFILE2_PROGRESS_CONTINUE	0	0x0	コピー操作を続行します。
COPYFILE2_PROGRESS_CANCEL	1	0x1	コピー操作をキャンセルします。CopyFile2 の呼び出しは失敗し、 `HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED)` を返します。また、部分的にコピーされたフラグメントは削除されます。
COPYFILE2_PROGRESS_STOP	2	0x2	コピー操作を停止します。CopyFile2 の呼び出しは失敗し、 `HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED)` を返します。また、部分的にコピーされたフラグメントはそのまま残されます。この操作を COPY_FILE_RESUME_FROM_PAUSE フラグを使用して再開できるのは、 CopyFile2 関数に渡された COPYFILE2_EXTENDED_PARAMETERS 構造体の dwCopyFlags メンバーに COPY_FILE_RESTARTABLE フラグが設定されていた場合のみです。
COPYFILE2_PROGRESS_QUIET	3	0x3	コピー操作を続行しますが、この操作に対して CopyFile2ProgressRoutine コールバック関数を再度呼び出しません。
COPYFILE2_PROGRESS_PAUSE	4	0x4	コピー操作を一時停止し、再開用のヘッダーを書き込みます。この値は、 COPYFILE2_EXTENDED_PARAMETERS 構造体の dwCopyFlags メンバーに対する COPY_FILE_RESTARTABLE フラグとは互換性がありません。ほとんどの場合、CopyFile2 の呼び出しは失敗し、 `HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED)` を返します。また、部分的にコピーされたフラグメントはそのまま残されます (後でコピー操作を再開するために使用される、書き込まれたヘッダーを除きます)。一時停止要求が処理された時点でコピー操作が完了していた場合は、 CopyFile2 の呼び出しは正常に完了し、再開用ヘッダーは書き込まれません。この値が処理された後、 COPYFILE2_MESSAGE 構造体の Type メンバーに COPYFILE2_CALLBACK_STREAM_FINISHED (4) の値を指定したメッセージで、 CopyFile2ProgressRoutine へのコールバックがもう一度行われます。そのコールバックから戻った後、CopyFile2 は `HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED)` で失敗します。

公式ドキュメント

保留中のコピー操作に対してどのような動作を行うかを示すために、 CopyFile2ProgressRoutine コールバック関数から返される値です。

解説(Remarks)

この列挙型を使用するアプリケーションをコンパイルするには、_WIN32_WINNT マクロを 0x0601 以降として定義してください。詳細については、 Using the Windows Headers を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum COPYFILE2_MESSAGE_ACTION : int {
    COPYFILE2_PROGRESS_CONTINUE = 0,
    COPYFILE2_PROGRESS_CANCEL = 1,
    COPYFILE2_PROGRESS_STOP = 2,
    COPYFILE2_PROGRESS_QUIET = 3,
    COPYFILE2_PROGRESS_PAUSE = 4
} COPYFILE2_MESSAGE_ACTION;

public enum COPYFILE2_MESSAGE_ACTION : int
{
    COPYFILE2_PROGRESS_CONTINUE = 0,
    COPYFILE2_PROGRESS_CANCEL = 1,
    COPYFILE2_PROGRESS_STOP = 2,
    COPYFILE2_PROGRESS_QUIET = 3,
    COPYFILE2_PROGRESS_PAUSE = 4,
}

Public Enum COPYFILE2_MESSAGE_ACTION As Integer
    COPYFILE2_PROGRESS_CONTINUE = 0
    COPYFILE2_PROGRESS_CANCEL = 1
    COPYFILE2_PROGRESS_STOP = 2
    COPYFILE2_PROGRESS_QUIET = 3
    COPYFILE2_PROGRESS_PAUSE = 4
End Enum

import enum

class COPYFILE2_MESSAGE_ACTION(enum.IntEnum):
    COPYFILE2_PROGRESS_CONTINUE = 0
    COPYFILE2_PROGRESS_CANCEL = 1
    COPYFILE2_PROGRESS_STOP = 2
    COPYFILE2_PROGRESS_QUIET = 3
    COPYFILE2_PROGRESS_PAUSE = 4

// COPYFILE2_MESSAGE_ACTION
pub const COPYFILE2_PROGRESS_CONTINUE: i32 = 0;
pub const COPYFILE2_PROGRESS_CANCEL: i32 = 1;
pub const COPYFILE2_PROGRESS_STOP: i32 = 2;
pub const COPYFILE2_PROGRESS_QUIET: i32 = 3;
pub const COPYFILE2_PROGRESS_PAUSE: i32 = 4;

// COPYFILE2_MESSAGE_ACTION
const (
	COPYFILE2_PROGRESS_CONTINUE int32 = 0
	COPYFILE2_PROGRESS_CANCEL int32 = 1
	COPYFILE2_PROGRESS_STOP int32 = 2
	COPYFILE2_PROGRESS_QUIET int32 = 3
	COPYFILE2_PROGRESS_PAUSE int32 = 4
)

const
  COPYFILE2_PROGRESS_CONTINUE = 0;
  COPYFILE2_PROGRESS_CANCEL = 1;
  COPYFILE2_PROGRESS_STOP = 2;
  COPYFILE2_PROGRESS_QUIET = 3;
  COPYFILE2_PROGRESS_PAUSE = 4;

// COPYFILE2_MESSAGE_ACTION
pub const COPYFILE2_PROGRESS_CONTINUE: i32 = 0;
pub const COPYFILE2_PROGRESS_CANCEL: i32 = 1;
pub const COPYFILE2_PROGRESS_STOP: i32 = 2;
pub const COPYFILE2_PROGRESS_QUIET: i32 = 3;
pub const COPYFILE2_PROGRESS_PAUSE: i32 = 4;

const
  COPYFILE2_PROGRESS_CONTINUE* = 0
  COPYFILE2_PROGRESS_CANCEL* = 1
  COPYFILE2_PROGRESS_STOP* = 2
  COPYFILE2_PROGRESS_QUIET* = 3
  COPYFILE2_PROGRESS_PAUSE* = 4

enum COPYFILE2_MESSAGE_ACTION : int {
    COPYFILE2_PROGRESS_CONTINUE = 0,
    COPYFILE2_PROGRESS_CANCEL = 1,
    COPYFILE2_PROGRESS_STOP = 2,
    COPYFILE2_PROGRESS_QUIET = 3,
    COPYFILE2_PROGRESS_PAUSE = 4,
}

#define global COPYFILE2_PROGRESS_CONTINUE 0x0
#define global COPYFILE2_PROGRESS_CANCEL   0x1
#define global COPYFILE2_PROGRESS_STOP     0x2
#define global COPYFILE2_PROGRESS_QUIET    0x3
#define global COPYFILE2_PROGRESS_PAUSE    0x4