Fungsi UnlockFileEx (fileapi.h)

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.

Persyaratan

Lihat juga

Mengunci dan Membuka Kunci Rentang Byte dalam File

CreateFile

Fungsi Manajemen File

LockFile

LockFileEx

TUMPANG TINDIH

I/O Sinkron dan Asinkron

UnlockFile