Fungsi NtReadOnlyEnlistment (wdm.h)
Rutinitas ZwReadOnlyEnlistment menetapkan daftar yang ditentukan menjadi baca-saja.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtReadOnlyEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Parameter
[in] EnlistmentHandle
Handel ke objek pendaftaran yang diperoleh oleh panggilan sebelumnya ke ZwCreateEnlistment atau ZwOpenEnlistment. Handel harus memiliki akses ENLISTMENT_SUBORDINATE_RIGHTS ke objek.
[in, optional] TmVirtualClock
Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
ZwReadOnlyEnlistment mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Handel yang ditentukan bukan handel ke objek pendaftaran. |
|
Handel objek tidak valid. |
|
Transaksi atau pendaftarannya tidak dalam status yang benar. Misalnya, pendaftaran tidak dapat bersifat baca-saja jika bendera ENLISTMENT_SUPERIOR ditentukan ke ZwCreateEnlistment. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran. |
Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.
Keterangan
Komponen Anda tidak dapat memanggil ZwReadOnlyEnlistment untuk pendaftaran yang unggul.
Untuk informasi selengkapnya tentang ZwReadOnlyEnlistment, lihat Membuat Read-Only Enlistment.
NtReadOnlyEnlistment dan ZwReadOnlyEnlistment adalah dua versi dari rutinitas Windows Native System Services yang sama.
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 | Tersedia di Windows Vista dan versi sistem operasi yang lebih baru. |
Target Platform | Universal |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli