Fungsi MoveFile (winbase.h)
Memindahkan file atau direktori yang ada, termasuk turunannya.
Untuk menentukan cara memindahkan file, gunakan fungsi MoveFileEx atau MoveFileWithProgress .
Untuk melakukan operasi ini sebagai operasi yang ditransaksikan, gunakan fungsi MoveFileTransacted .
Sintaks
BOOL MoveFile(
[in] LPCTSTR lpExistingFileName,
[in] LPCTSTR lpNewFileName
);
Parameter
[in] lpExistingFileName
Nama file atau direktori saat ini pada komputer lokal.
Secara default, nama terbatas pada MAX_PATH karakter. Untuk memperpanjang batas ini menjadi 32.767 karakter lebar, tambahkan "\\?\" ke jalur. Untuk informasi selengkapnya, lihat Menamai File, Jalur, dan Namespace.
Tip
Dimulai dengan Windows 10, Versi 1607, Anda dapat ikut serta untuk menghapus batasan MAX_PATH tanpa menambahkan awalan "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" dari Penamaan File, Jalur, dan Namespace untuk detailnya.
[in] lpNewFileName
Nama baru untuk file atau direktori. Nama baru belum boleh ada. Berkas baru mungkin ada pada sistem berkas atau kandar yang berbeda. Direktori baru harus berada di drive yang sama.
Secara default, nama terbatas pada MAX_PATH karakter. Untuk memperpanjang batas ini menjadi 32.767 karakter lebar, tambahkan "\\?\" ke jalur. Untuk informasi selengkapnya, lihat Menamai File, Jalur, dan Namespace.
Tip
Dimulai dengan Windows 10, Versi 1607, Anda dapat ikut serta untuk menghapus batasan MAX_PATH tanpa menambahkan awalan "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" dari Penamaan File, Jalur, dan Namespace untuk detailnya.
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.
Keterangan
Fungsi MoveFile akan memindahkan (mengganti nama) baik file atau direktori (termasuk turunannya) baik di direktori yang sama atau di seluruh direktori. Satu peringatan adalah bahwa fungsi MoveFile akan gagal pada direktori bergerak ketika tujuan berada pada volume yang berbeda.
Jika file dipindahkan di seluruh volume, MoveFile tidak memindahkan deskriptor keamanan dengan file . File akan diberi pendeskripsi keamanan default di direktori tujuan.
Fungsi MoveFile mengoordinasikan operasinya dengan layanan pelacakan tautan, sehingga sumber tautan dapat dilacak saat dipindahkan.
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 | Ya |
| SMB 3.0 Transparent Failover (TFO) | Lihat komentar |
| SMB 3.0 dengan Scale-out File Shares (SO) | Lihat komentar |
| Sistem File Volume Bersama Kluster (CsvFS) | Ya |
| Sistem File Tangguh (ReFS) | Ya |
SMB 3.0 tidak mendukung penggantian nama aliran data alternatif pada berbagi file dengan kemampuan ketersediaan berkelanjutan.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |