CopyFileFromAppW 函数（fileapifromapp.h）

将现有文件复制到新文件。 此函数的行为与 CopyFile 相同，只不过此函数遵循通用 Windows 平台应用安全模型。

Syntax

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。

要求