COPYFILE2_EXTENDED_PARAMETERS構造体 (winbase.h)

CopyFile2 関数の拡張パラメーターが含まれます。

構文

typedef struct COPYFILE2_EXTENDED_PARAMETERS {
  DWORD                       dwSize;
  DWORD                       dwCopyFlags;
  BOOL                        *pfCancel;
  PCOPYFILE2_PROGRESS_ROUTINE pProgressRoutine;
  PVOID                       pvCallbackContext;
} COPYFILE2_EXTENDED_PARAMETERS;

メンバー

dwSize

この構造体のサイズを格納します sizeof(COPYFILE2_EXTENDED_PARAMETERS)。

dwCopyFlags

これらのフラグ値の 0 個以上の組み合わせを含みます。

値	意味
COPY_FILE_FAIL_IF_EXISTS 0x00000001	コピー先ファイルが存在する場合、コピー操作はすぐに失敗します。 コピー先の名前を持つファイルまたはディレクトリが存在する場合、CopyFile2 関数の呼び出しは または HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)のいずれかでHRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)失敗します。 COPY_FILE_RESUME_FROM_PAUSEも指定されている場合、ターゲット ファイルに有効な再起動ヘッダーがない場合にのみエラーがトリガーされます。
COPY_FILE_RESTARTABLE 0x00000002	ファイルは、同じソースファイル名とコピー先ファイル名が再び使用された場合に再起動できる方法でコピーされます。 これは遅くなります。
COPY_FILE_OPEN_SOURCE_FOR_WRITE 0x00000004	ファイルがコピーされ、ソース ファイルが書き込みアクセス用に開かれます。
COPY_FILE_ALLOW_DECRYPTED_DESTINATION 0x00000008	コピー先ファイルを暗号化できない場合でも、コピーが試行されます。
COPY_FILE_COPY_SYMLINK 0x00000800	ソース ファイルがシンボリック リンクの場合、変換先ファイルは、ソース シンボリック リンクと同じファイルを指すシンボリック リンクでもあります。
COPY_FILE_NO_BUFFERING 0x00001000	コピーはバッファーなしの I/O を使用して実行され、システム キャッシュ リソースはバイパスされます。 このフラグは、非常に大きなファイル コピーに推奨されます。 このフラグを使用しているコピーを一時停止することはお勧めしません。
COPY_FILE_REQUEST_SECURITY_PRIVILEGES 0x00002000	コピーが試行され、ソース ファイルとACCESS_SYSTEM_SECURITY \| WRITE_DAC \| WRITE_OWNERコピー先ファイルが指定ACCESS_SYSTEM_SECURITYされます。 これらの要求が拒否された場合、アクセス要求は、アクセスが許可される最高の特権レベルに縮小されます。 詳細については、「 SACL Access Right」を参照してください。 これを使用すると、 CopyFile2ProgressRoutine コールバックで、ファイルのセキュリティ属性のコピーなど、より高い特権を必要とする操作を実行できます。
COPY_FILE_RESUME_FROM_PAUSE 0x00004000	コピー先ファイルは、COPY_FILE_RESTARTABLEを使用してコピーされたかどうかを確認するために調 べられます。 その場合は、コピーが再開されます。 そうでない場合、ファイルは完全にコピーされます。
COPY_FILE_NO_OFFLOAD 0x00040000	Windows コピー オフロード メカニズムを使用しないでください。 これは一般的にはお勧めしません。
COPY_FILE_IGNORE_EDP_BLOCK 0x00400000	ファイルをブロックするのではなく、コピー先のファイル システムでサポートされている場合は、コピー先で暗号化する必要があります。 Windows 10 以降でサポートされます。
COPY_FILE_IGNORE_SOURCE_ENCRYPTION 0x00800000	ソース ファイルの暗号化された状態を無視します。 Windows 10 以降でサポートされます。
COPY_FILE_DONT_REQUEST_DEST_WRITE_DAC 0x02000000	転送先のファイル アクセスのWRITE_DACを要求しないでください。 Windows 10 以降でサポートされます。
COPY_FILE_OPEN_AND_COPY_REPARSE_POINT 0x00200000	型に関係なく、必ず再解析ポイントをコピーします。 再解析ポイントの意味を理解するのは呼び出し元の責任です。 Windows 10、ビルド 19041 以降でサポートされます。
COPY_FILE_DIRECTORY 0x00000080	ソース ファイルがディレクトリ ファイルであることを示します。 指定すると、ソース ファイルが で FILE_OPEN_FOR_BACKUP_INTENT開かれます。 ディレクトリ ファイルには、代替データ ストリーム、再解析ポイント情報、および通常のファイルのようにコピーされた EA が含まれます。 Windows 10、ビルド 19041 以降でサポートされます。
COPY_FILE_SKIP_ALTERNATE_STREAMS 0x00008000	代替データ ストリームをコピーしないでください。 Windows 10、ビルド 19041 以降でサポートされます。
COPY_FILE_DISABLE_PRE_ALLOCATION 0x04000000	コピーを実行する前に、コピー先のファイル サイズを事前に割り当てないでください。 Windows 10、ビルド 19041 以降でサポートされます。
COPY_FILE_ENABLE_LOW_FREE_SPACE_MODE 0x08000000	LowFreeSpace モードを有効にします。 重複する I/O は使用されません。 ODX と SMB オフロードは試行されません。 Windows 10、ビルド 19041 以降でサポートされます。
COPY_FILE_REQUEST_COMPRESSED_TRAFFIC 0x10000000	コピー操作中に、基になる転送チャネルにデータの圧縮を要求します。 要求は、すべてのメディアでサポートされていない場合があり、その場合は無視されます。 圧縮属性とパラメーター (計算の複雑さ、メモリ使用量) は、この API では構成できません。また、異なる OS リリース間で変更される可能性があります。 Windows Server 2022 および Windows 10、ビルド 1903 以降でサポートされています。 (Windows 10では、このフラグは SMB 共有に存在するファイルでサポートされます。この場合、ネゴシエートされた SMB プロトコルのバージョンは SMB v3.1.1 以降です)。
COPY_FILE_ENABLE_SPARSE_COPY 0x20000000	コピー中にファイルのスパース状態を保持できるようにします。 Windows 11、ビルド 22H2 以降でサポートされます。

pfCancel

コピー操作中にこのフラグが TRUE に設定されている場合、コピー操作は取り消されます。

pProgressRoutine

ファイルの別の部分がコピーされるたびに呼び出される PCOPYFILE2_PROGRESS_ROUTINE 型のコールバック関数の省略可能なアドレス。 このパラメーターは、NULL でもかまいません。 進行状況コールバック関数の詳細については、 CopyFile2ProgressRoutine コールバック関数を参照してください。

pvCallbackContext

CopyFile2ProgressRoutine に渡されるアプリケーション固有のコンテキスト情報へのポインター。

注釈

この構造を使用するアプリケーションをコンパイルするには、 _WIN32_WINNT マクロを _WIN32_WINNT_WIN8 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
Header	winbase.h (Windows.h を含む)

こちらもご覧ください

CopyFile2

CopyFile2ProgressRoutine

ファイル管理の構造体

COPYFILE2_EXTENDED_PARAMETERS_V2