Fungsi UnlockFile (fileapi.h)
Membuka kunci wilayah dalam file yang terbuka. Membuka kunci wilayah memungkinkan proses lain untuk mengakses wilayah.
Untuk cara alternatif untuk menentukan wilayah, gunakan fungsi UnlockFileEx .
Sintaks
BOOL UnlockFile(
[in] HANDLE hFile,
[in] DWORD dwFileOffsetLow,
[in] DWORD dwFileOffsetHigh,
[in] DWORD nNumberOfBytesToUnlockLow,
[in] DWORD nNumberOfBytesToUnlockHigh
);
Parameter
[in] hFile
Handel ke file yang berisi wilayah yang dikunci dengan LockFile. Handel file harus dibuat dengan hak akses GENERIC_READ atau GENERIC_WRITE . Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.
[in] dwFileOffsetLow
Kata rendah dari offset byte awal dalam file tempat wilayah terkunci dimulai.
[in] dwFileOffsetHigh
Kata urutan tinggi dari offset byte awal dalam file tempat wilayah terkunci dimulai.
[in] nNumberOfBytesToUnlockLow
Kata berurutan rendah dari panjang rentang byte yang akan dibuka kuncinya.
[in] nNumberOfBytesToUnlockHigh
Kata berurutan tinggi dari panjang rentang byte yang akan dibuka kuncinya.
Menampilkan nilai
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 ini selalu beroperasi secara sinkron, tetapi mungkin tidak mengantrekan entri penyelesaian ketika port penyelesaian dikaitkan dengan handel file.
Membuka kunci wilayah file melepaskan kunci yang diperoleh sebelumnya pada file. Wilayah untuk membuka kunci harus sesuai persis dengan wilayah terkunci yang ada. Dua wilayah file yang berdampingan tidak dapat dikunci secara terpisah lalu dibuka kuncinya menggunakan satu wilayah yang mencakup kedua wilayah terkunci.
Jika proses berakhir dengan sebagian file terkunci atau menutup file yang memiliki kunci yang luar biasa, kunci akan dibuka oleh sistem operasi. Namun, waktu yang diperlukan sistem operasi untuk membuka kunci ini tergantung pada sumber daya sistem yang tersedia. Oleh karena itu, disarankan agar proses Anda secara eksplisit membuka kunci semua file yang telah dikuncinya saat dihentikan. Jika ini tidak dilakukan, akses ke file-file ini dapat ditolak jika sistem operasi belum membukanya.
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) | Ya |
| SMB 3.0 dengan Berbagi File Peluasan Skala (SO) | Ya |
| Sistem File Volume Bersama Kluster (CsvFS) | Ya |
| Sistem File Tangguh (ReFS) | Ya |
Persyaratan
| Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | fileapi.h (sertakan Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |