CopyFileFromAppW 函式 （fileapifromapp.h）

將現有的檔案複製到新的檔案。 此函式的行為與 CopyFile 相同，但此函式會遵循通用 Windows 平臺應用程式安全性模型。

語法

WINSTORAGEAPI BOOL CopyFileFromAppW(
  LPCWSTR lpExistingFileName,
  LPCWSTR lpNewFileName,
  BOOL    bFailIfExists
) noexcept;

參數

lpExistingFileName

現有檔案的名稱。

如需選擇退出 MAX_PATH 限制而不加上前置 “\\？\” 的資訊，請參閱 命名檔案、路徑和命名空間 的「路徑長度限制上限」一節以取得詳細資訊。

如果 lpExistingFileName 不存在，函式會失敗，而 GetLastError 會傳回 ERROR_FILE_NOT_FOUND。

lpNewFileName

新檔案的名稱。

在此功能的 ANSI 版本中，名稱僅限於 MAX_PATH 個字元。 若要將此限制延伸至 32,767 個寬字元，請呼叫函式的 Unicode 版本，並將 “\\？\” 附加到路徑前面。 如需詳細資訊，請參閱 命名檔案。

針對此函式的 Unicode 版本 （CopyFileFromAppW） ，您可以選擇加入移除 MAX_PATH 限制，而不加上前面的 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間 的「最大路徑長度限制」一節。

bFailIfExists

如果此參數為 TRUE ，且 lpNewFileName 所指定的新檔案已存在，則函式會失敗。 如果此參數為 FALSE ，且新檔案已存在，則函式會覆寫現有的檔案並成功。

返回值

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

如果函式失敗，傳回值為零。 若要取得擴充錯誤資訊，請呼叫 GetLastError。

需求