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_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE。

呼叫端必須具有要取代之檔案的寫入權限。 如需詳細資訊，請參閱 檔案安全性和存取權限。

lpReplacementFileName

將取代 lpReplacedFileName 檔案的檔案名。

如需退出宣告 MAX_PATH 限制而不加上 「\\？\」 的詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節以取得詳細資料。

函式會嘗試使用 SYNCHRONIZE、 GENERIC_READ、 GENERIC_WRITE、 DELETE和 WRITE_DAC 存取權限來開啟此檔案，以便保留所有屬性和 ACL。 如果失敗，函式會嘗試使用 SYNCHRONIZE、 GENERIC_READ、 DELETE和 WRITE_DAC 存取權限來開啟檔案。 未指定共用模式。

lpBackupFileName

將做為 lpReplacedFileName 檔案備份複本的檔案名。 如果此參數為 Null，則不會建立備份檔案。 如需備份檔案的實作詳細資料，請參閱一節。

如需退出宣告 MAX_PATH 限制而不加上 「\\？\」 的詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節以取得詳細資料。

dwReplaceFlags

取代選項。 此參數可以是下列一或多個值。

值	意義
REPLACEFILE_WRITE_THROUGH 0x00000001	不支援這個值。
REPLACEFILE_IGNORE_MERGE_ERRORS 0x00000002	忽略將資訊合併 (時發生的錯誤，例如屬性和 ACL) 從取代的檔案到取代檔案。 因此，如果您指定此旗標且沒有 WRITE_DAC 存取權，則函式會成功，但不會保留 ACL。
REPLACEFILE_IGNORE_ACL_ERRORS 0x00000004	忽略將 ACL 資訊從取代的檔案合併至取代檔案時所發生的錯誤。 因此，如果您指定此旗標且沒有 WRITE_DAC 存取權，則函式會成功，但不會保留 ACL。 若要編譯使用此值的應用程式，請將_WIN32_WINNT巨集定義為 0x0600 或更新版本。

lpExclude

保留供未來使用。

lpReserved

保留供未來使用。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 以下是此函式的可能錯誤碼。

傳回碼/值	描述
ERROR_UNABLE_TO_MOVE_REPLACEMENT 1176 (0x498)	無法重新命名取代檔案。 如果指定 了 lpBackupFileName ，取代和取代的檔案會保留其原始檔案名稱。 否則，已取代的檔案已不存在，且取代檔案會以其原始名稱存在。
ERROR_UNABLE_TO_MOVE_REPLACEMENT_2 1177 (0x499)	無法移動取代檔案。 取代檔案仍然存在於原始名稱下;不過，它已從它所取代的檔案繼承檔案資料流程和屬性。 要取代的檔案仍會以不同的名稱存在。 如果指定 lpBackupFileName ，它會是已取代檔案的名稱。
ERROR_UNABLE_TO_REMOVE_REPLACED 1175 (0x497)	無法刪除已取代的檔案。 已取代和取代的檔案會保留其原始檔案名稱。

 

如果傳回任何其他錯誤，例如 ERROR_INVALID_PARAMETER，取代和取代的檔案會保留其原始檔案名稱。 在此案例中，備份檔案不存在，而且不保證取代檔案會繼承已取代檔案的所有屬性和資料流程。

需求

最低支援的用戶端	Windows 10 (版本 1803)
標頭	fileapifromapp.h