Функция 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 символов в ширину, вызовите версию функции в Юникоде и добавьте к пути "\\?\". Дополнительные сведения см. в разделе Именование файла.

Для версии юникода этой функции (CopyFileFromAppW) можно согласиться на удаление ограничения MAX_PATH без добавления в начало "\\?\". Дополнительные сведения см. в разделе "Ограничение максимальной длины пути" статьи Именование файлов, путей и пространств имен .

bFailIfExists

Если этот параметр имеет значение TRUE и новый файл, указанный в параметре lpNewFileName , уже существует, функция завершается ошибкой. Если этот параметр имеет значение FALSE и новый файл уже существует, функция перезаписывает существующий файл и выполняется успешно.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

   
Минимальная версия клиента Windows 10 версии 1803
Верхняя часть fileapifromapp.h