CopyFile2

既存ファイルを新しいファイルにコピーし、コールバック関数を通じて進捗をアプリケーションに通知する。(CopyFile2)

CopyFile2 pwszExistingFileName, pwszNewFileName, pExtendedParameters

pwszExistingFileName : [wstr] 既存ファイルの名前。この制限を 32,767 ワイド文字まで拡張するには、パスの先頭に "\\?\" を付ける。詳細は Naming Files, Paths, and Namespaces を参照。ヒント: Windows 10 バージョン 1607 以降、"\\?\" を前置せずに MAX_PATH 文字数制限を取り除くことにオプトインできる。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Limitation" セクションを参照。lpExistingFileName が存在しない場合、CopyFile2 関数は失敗し HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) を返す。
pwszNewFileName : [wstr] 新しいファイルの名前。この制限を 32,767 ワイド文字まで拡張するには、パスの先頭に "\\?\" を付ける。詳細は Naming Files, Paths, and Namespaces を参照。ヒント: Windows 10 バージョン 1607 以降、"\\?\" を前置せずに MAX_PATH 文字数制限を取り除くことにオプトインできる。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Limitation" セクションを参照。
pExtendedParameters : [var] COPYFILE2_EXTENDED_PARAMETERS 構造体のアドレス（省略可）。

(プラグイン / モジュール : kernel32.dll)

解説

既存ファイルを新しいファイルにコピーし、コールバック関数を通じて進捗をアプリケーションに通知する。(CopyFile2)

[戻り値]
関数が成功した場合、戻り値は SUCCEEDED マクロに渡したときに TRUE となる。
（以下省略）

[備考]
この関数は拡張属性、OLE 構造化ストレージ、NTFS
代替データストリーム、ファイル属性を保持する。既存ファイルのセキュリティ属性は新しいファイルにはコピーされない。セキュリティ属性をコピーするには
SHFileOperation 関数を使う。コピー先ファイルがすでに存在し FILE_ATTRIBUTE_HIDDEN または
FILE_ATTRIBUTE_READONLY 属性が設定されている場合、この関数は
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
で失敗する。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT マクロを _WIN32_WINNT_WIN8
以降として定義する。詳細は Using the Windows Headers を参照。Windows 8 および Windows
Server 2012 では、この関数は以下の技術でサポートされている。
（以下省略）

情報