ReplaceFileFromAppW 関数 (fileapifromapp.h)

元のファイルのバックアップ コピーを作成するオプションを使って、あるファイルを別のファイルに置き換えます。 この関数の動作は ReplaceFile と同じですが、この関数はユニバーサル Windows プラットフォームアプリ セキュリティ モデルに準拠しています。

構文

WINSTORAGEAPI BOOL ReplaceFileFromAppW(
  LPCWSTR lpReplacedFileName,
  LPCWSTR lpReplacementFileName,
  LPCWSTR lpBackupFileName,
  DWORD   dwReplaceFlags,
  LPVOID  lpExclude,
  LPVOID  lpReserved
) noexcept;

パラメーター

lpReplacedFileName

前もって "\\?\" を指定せずに MAX_PATH 制限をオプトアウトする方法については、「 名前付けファイル、パス、および名前空間 」の「パスの最大長制限」セクションを参照してください。

このファイルは、 GENERIC_READ、 DELETE、 SYNCHRONIZE アクセス権で開かれます。 共有モードは 、FILE_SHARE_DELETE | FILE_SHARE_WRITE | FILE_SHARE_READ。

呼び出し元は、置き換えるファイルへの書き込みアクセス権を持っている必要があります。 詳細については、「 ファイル のセキュリティとアクセス権」を参照してください。

lpReplacementFileName

lpReplacedFileName ファイルを置き換えるファイルの名前。

前もって "\\?\" を指定せずに MAX_PATH 制限をオプトアウトする方法については、「 名前付けファイル、パス、および名前空間 」の「パスの最大長制限」セクションを参照してください。

関数は、すべての属性と ACL を保持できるように、 SYNCHRONIZE、 GENERIC_READ、 GENERIC_WRITE、 DELETE、 WRITE_DAC アクセス権を使用してこのファイルを開こうとします。 これが失敗した場合、関数は SYNCHRONIZE、GENERIC_READ、DELETE、WRITE_DAC アクセス権を使用してファイルを開こうとします。 共有モードは指定されません。

lpBackupFileName

lpReplacedFileName ファイルのバックアップ コピーとして機能するファイルの名前。 このパラメーターが NULL の場合、バックアップ ファイルは作成されません。 バックアップ ファイルの実装の詳細については、「解説」セクションを参照してください。

前もって "\\?\" を指定せずに MAX_PATH 制限をオプトアウトする方法については、「 名前付けファイル、パス、および名前空間 」の「パスの最大長制限」セクションを参照してください。

dwReplaceFlags

置換オプション。 このパラメーターには、次の 1 つ以上の値を指定できます。

lpExclude

将来使用するために予約されています。

lpReserved

将来使用するために予約されています。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 この関数で発生する可能性のあるエラー コードを次に示します。

ERROR_INVALID_PARAMETERなどの他のエラーが返された場合、置換されたファイルと置換されたファイルは元のファイル名を保持します。 このシナリオでは、バックアップ ファイルは存在せず、置き換えられたファイルのすべての属性とストリームが置換ファイルによって継承されるとは限りません。

要件