Fungsi TmReadOnlyEnlistment (wdm.h)

Artikel
02/27/2024

Rutinitas TmReadOnlyEnlistment menetapkan daftar yang ditentukan menjadi baca-saja.

Sintaks

NTSTATUS TmReadOnlyEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] Enlistment

Penunjuk ke objek pendaftaran. Komponen Anda dapat menerima pointer ini sebagai input ke rutinitas panggilan balik ResourceManagerNotification . Atau, komponen Anda dapat memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang dipanggil sebelumnya ke ZwCreateEnlistment, TmCreateEnlistment, atau ZwOpenEnlistment yang disediakan.

[in] TmVirtualClock

Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_TRANSACTION_NOT_REQUESTED	Transaksi atau pendaftarannya tidak dalam status yang benar. Misalnya, pendaftaran tidak dapat bersifat baca-saja jika bendera ENLISTMENT_SUPERIOR ditentukan ke ZwCreateEnlistment.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas TmReadOnlyEnlistment adalah versi berbasis pointer dari rutinitas ZwReadOnlyEnlistment .

Untuk informasi tentang kapan harus menggunakan rutinitas TmXxx KTM alih-alih rutinitas ZwXxx , lihat Menggunakan Rutinitas TmXxx.

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