Fungsi UnlockFileEx (fileapi.h)

Artikel
08/23/2023

Membuka kunci wilayah dalam file yang ditentukan. Fungsi ini dapat beroperasi baik secara sinkron atau asinkron.

Sintaks

BOOL UnlockFileEx(
  [in]      HANDLE       hFile,
            DWORD        dwReserved,
  [in]      DWORD        nNumberOfBytesToUnlockLow,
  [in]      DWORD        nNumberOfBytesToUnlockHigh,
  [in, out] LPOVERLAPPED lpOverlapped
);

Parameter

[in] hFile

Handel ke file. Handel harus dibuat dengan hak akses GENERIC_READ atau GENERIC_WRITE . Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.

dwReserved

Parameter yang dicadangkan; harus nol.

[in] nNumberOfBytesToUnlockLow

Bagian berurutan rendah dari panjang rentang byte untuk membuka kunci.

[in] nNumberOfBytesToUnlockHigh

Bagian urutan tinggi dari panjang rentang byte untuk membuka kunci.

[in, out] lpOverlapped

Penunjuk ke struktur TUMPANG TINDIH yang digunakan fungsi dengan permintaan membuka kunci. Struktur ini berisi offset file dari awal rentang buka kunci. Anda harus menginisialisasi anggota hEvent ke handel atau nol yang valid. Untuk informasi selengkapnya, lihat I/O Sinkron dan Asinkron.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

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.

Kunci dirilis sebelum fungsi CloseHandle selesai diproses.

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