Fungsi NtUnlockFile (ntifs.h)

  • Artikel

Rutinitas NtUnlockFile membuka kunci rentang byte dalam file.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtUnlockFile(
  [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 NtUnlockFile 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 NtUnlockFile 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 NtUnlockFile . Tidak dimungkinkan untuk membuka kunci dua rentang yang berdekatan yang sebelumnya terkunci dengan satu panggilan ke NtUnlockFile. Tidak dimungkinkan juga untuk membuka kunci bagian dari rentang yang sebelumnya dikunci dengan satu panggilan ke rutinitas NtUnlockFile .

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

Catatan

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

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, PowerIrpDDis

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

NtLockFile