通过

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