Fungsi ZwUnlockFile (ntifs.h)

Rutinitas ZwUnlockFile membuka kunci rentang byte dalam file.

Sintaksis

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 byte-nya 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 pemanggil yang digunakan untuk menjelaskan grup kunci terkait. Nilai ini harus diatur ke nol.

Mengembalikan nilai

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

Komentar

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

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

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

Persyaratan

Lihat juga

ZwLockFile