Fungsi UnlockFile (fileapi.h)

Artikel
08/23/2023

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