ReplaceFileW

ファイルを別のファイルで置き換える。元ファイルのバックアップコピーを作成するオプションを持つ。(Unicode)

ReplaceFileW lpReplacedFileName, lpReplacementFileName, lpBackupFileName, dwReplaceFlags, lpExclude, lpReserved

lpReplacedFileName : [wstr] 置き換え対象のファイル名。この関数の ANSI 版では名前は MAX_PATH 文字に制限される。この制限を 32,767 ワイド文字まで拡張するには、Unicode 版を呼び出し、パスの先頭に "\\?\" を付加する。詳細は Naming a File を参照。ヒント: Windows 10 バージョン 1607 以降、この関数の Unicode 版(ReplaceFileW)では、"\\?\" を付加せずに MAX_PATH 制限を解除するオプトインが可能である。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Length Limitation" セクションを参照。このファイルは GENERIC_READ、DELETE、および SYNCHRONIZE アクセス権で開かれる。共有モードは FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE である。呼び出し側は置き換え対象ファイルへの書き込みアクセス権を持つ必要がある。詳細は File Security and Access Rights を参照。
lpReplacementFileName : [wstr] lpReplacedFileName ファイルを置き換えるファイルの名前。この関数の ANSI 版では名前は MAX_PATH 文字に制限される。この制限を 32,767 ワイド文字まで拡張するには、Unicode 版を呼び出し、パスの先頭に "\\?\" を付加する。詳細は Naming a File を参照。ヒント: Windows 10 バージョン 1607 以降、この関数の Unicode 版(ReplaceFileW)では、"\\?\" を付加せずに MAX_PATH 制限を解除するオプトインが可能である。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Length Limitation" セクションを参照。関数は全ての属性と ACL を保持するため、SYNCHRONIZE、GENERIC_READ、GENERIC_WRITE、DELETE、および WRITE_DAC アクセス権でこのファイルを開こうとする。これに失敗した場合、関数は SYNCHRONIZE、GENERIC_READ、DELETE、および WRITE_DAC アクセス権でファイルを開こうとする。共有モードは指定されない。
lpBackupFileName : [wstr] lpReplacedFileName ファイルのバックアップコピーとして扱われるファイルの名前。このパラメータが NULL の場合、バックアップファイルは作成されない。バックアップファイルの実装詳細は Remarks セクションを参照。この関数の ANSI 版では名前は MAX_PATH 文字に制限される。この制限を 32,767 ワイド文字まで拡張するには、Unicode 版を呼び出し、パスの先頭に "\\?\" を付加する。詳細は Naming a File を参照。ヒント: Windows 10 バージョン 1607 以降、この関数の Unicode 版(ReplaceFileW)では、"\\?\" を付加せずに MAX_PATH 制限を解除するオプトインが可能である。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Length Limitation" セクションを参照。
dwReplaceFlags : [int] 
lpExclude : [intptr] 将来の使用のために予約されている。
lpReserved : [intptr] 将来の使用のために予約されている。

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

解説

ファイルを別のファイルで置き換える。元ファイルのバックアップコピーを作成するオプションを持つ。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 である。拡張エラー情報を取得するには
GetLastError を呼び出す。この関数の想定されるエラーコードは次のとおり。
（以下省略）

[備考]
ヒント: Windows 10 バージョン 1607 以降、この関数の Unicode 版(ReplaceFileW)では
MAX_PATH 制限を解除するオプトインが可能である。詳細は Naming Files, Paths, and Namespaces の
"Maximum Path Length Limitation" セクションを参照。ReplaceFile 関数は複数の手順を 1
つの関数にまとめている。アプリケーションは、新しいファイルへのデータ保存、一時名を使った元ファイルのリネーム、新しいファイルを元ファイルと同じ名前にリネーム、元ファイルの削除という個別の関数呼び出しの代わりに
ReplaceFile を呼び出すことができる。もう 1 つの利点として、ReplaceFile
は新しいファイルデータをコピーするだけでなく、元ファイルの次の属性を保持する。
（以下省略）

情報