Fungsi ZwUnlockFile (ntifs.h)

  • Artikel

Rutinitas ZwUnlockFile membuka kunci rentang byte dalam file.

Sintaks

NTSYSAPI NTSTATUS ZwUnlockFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PLARGE_INTEGER   ByteOffset,
  [in]  PLARGE_INTEGER   Length,
  [in]  ULONG            Key
);

Parameter

[in] FileHandle

Handel untuk objek file yang mewakili file yang rentang bytenya akan dibuka kuncinya.

[out] IoStatusBlock

Penunjuk ke struktur IO_STATUS_BLOCK yang berisi status akhir.

[in] ByteOffset

Penunjuk ke variabel yang menentukan offset byte awal agar rentang byte tidak terkunci.

[in] Length

Penunjuk ke variabel yang menentukan panjang, dalam byte, dari rentang byte untuk membuka kunci.

[in] Key

Nilai yang ditetapkan penelepon yang digunakan untuk menjelaskan grup kunci terkait. Nilai ini harus diatur ke nol.

Nilai kembali

Rutinitas ZwUnlockFile mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai. Kemungkinan nilai NTSTATUS meliputi:

Menampilkan kode Deskripsi
STATUS_RANGE_NOT_LOCKED Rentang byte yang ditentukan tidak dikunci.

Keterangan

Rutinitas ZwUnlockFile mengambil rentang byte seperti yang ditentukan oleh argumen ByteOffset dan Length . Rentang ini harus identik dengan rentang byte dalam file yang sebelumnya dikunci dengan satu panggilan ke rutinitas ZwUnlockFile . Tidak dimungkinkan untuk membuka kunci dua rentang yang berdekatan yang sebelumnya terkunci dengan satu panggilan ke ZwUnlockFile. Tidak dimungkinkan juga untuk membuka bagian dari rentang yang sebelumnya dikunci dengan satu panggilan ke rutinitas ZwUnlockFile .

Pemanggil ZwUnlockFile harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC kernel khusus diaktifkan**.

Catatan

Jika panggilan ke fungsi ZwUnlockFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtUnlockFile" alih-alih "ZwUnlockFile".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

ZwLockFile