Fungsi NtReadOnlyEnlistment (wdm.h)

ZwReadOnlyEnlistment rutin menetapkan pendaftaran tertentu menjadi baca-saja.

Sintaksis

C++

__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 NULL.

Mengembalikan nilai

ZwReadOnlyEnlistment mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Mengembalikan kode	Deskripsi
STATUS_OBJECT_TYPE_MISMATCH	Handel yang ditentukan bukan handel ke objek enlistment.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_TRANSACTION_NOT_REQUESTED	Transaksi atau pendaftarannya tidak dalam status yang benar. Misalnya, pendaftaran tidak dapat dibaca-saja jika bendera ENLISTMENT_SUPERIOR ditentukan untuk ZwCreateEnlistment.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran.

 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Komentar

Komponen Anda tidak dapat memanggil ZwReadOnlyEnlistment untuk pendaftaran unggul.

Untuk informasi selengkapnya tentang ZwReadOnlyEnlistment , lihat MembuatPendaftaran Read-Only .

NtReadOnlyEnlistment dan ZwReadOnlyEnlistment adalah dua versi dari rutinitas Windows Native System Services yang sama.

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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Platform Target	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

ZwCreateEnlistment

ZwOpenEnlistment