Fungsi MoveFile (winbase.h)

Artikel
06/02/2023

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.

Tip

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

Lihat juga

CopyFile

Fungsi Manajemen File

MoveFileEx

MoveFileTransacted

MoveFileWithProgress