Bagikan melalui


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

Lihat juga

Mengunci dan Membuka Kunci Rentang Byte dalam File

CreateFile

Fungsi Manajemen File

LockFile

UnlockFileEx