ReplaceFileFromAppW 関数 (fileapifromapp.h)

1 つのファイルを別のファイルに置き換え、元のファイルのバックアップ コピーを作成するオプションで置き換えます。 この関数の動作は 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_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETEです。

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

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

Requirements