Fungsi CopyFileFromAppW (fileapifromapp.h)

Menyalin file yang sudah ada ke file baru. Perilaku fungsi ini identik dengan CopyFile, kecuali bahwa fungsi ini mematuhi model keamanan aplikasi Platform Windows Universal.

Sintaks

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

Parameter

lpExistingFileName

Nama file yang ada.

Untuk informasi tentang menolak batasan MAX_PATH tanpa menambahkan "\\?\", lihat bagian "Batasan Panjang Jalur Maksimum" dari Penamaan File, Jalur, dan Namespace untuk detailnya.

Jika lpExistingFileName tidak ada, fungsi gagal, dan GetLastError mengembalikan ERROR_FILE_NOT_FOUND.

lpNewFileName

Nama file baru.

Dalam versi ANSI dari fungsi ini, namanya terbatas pada MAX_PATH karakter. Untuk memperpanjang batas ini menjadi 32.767 karakter lebar, panggil versi Unicode fungsi dan prepend "\\?\" ke jalur. Untuk informasi selengkapnya, lihat Penamaan File.

Untuk versi unicode fungsi ini (CopyFileFromAppW), Anda dapat memilih untuk menghapus batasan MAX_PATH tanpa menambahkan "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" di Penamaan File, Jalur, dan Namespace untuk detailnya.

bFailIfExists

Jika parameter ini TRUE dan file baru yang ditentukan oleh lpNewFileName sudah ada, fungsi gagal. Jika parameter ini FALSE dan file baru sudah ada, fungsi akan menimpa file yang ada dan berhasil.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Klien minimum yang didukung	Windows 10, versi 1803
Header	fileapifromapp.h