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。


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