Fungsi NtQueryInformationEnlistment (wdm.h)

Rutinitas ZwQueryInformationEnlistment mengambil informasi tentang objek pendaftaran tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
  [in]            HANDLE                       EnlistmentHandle,
  [in]            ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [out]           PVOID                        EnlistmentInformation,
  [in]            ULONG                        EnlistmentInformationLength,
  [out, optional] PULONG                       ReturnLength
);

Parameter

[in] EnlistmentHandle

Handel ke objek pendaftaran yang diperoleh oleh panggilan sebelumnya ke ZwCreateEnlistment atau ZwOpenEnlistment. Handel harus memiliki akses ENLISTMENT_QUERY_INFORMATION ke objek .

[in] EnlistmentInformationClass

Nilai enumerasi jenis ENLISTMENT_INFORMATION_CLASS yang menentukan informasi yang akan diperoleh. Nilai ini harus menjadi salah satu nilai berikut:

  • EnlistmentBasicInformation
  • EnlistmentRecoveryInformation
Nilai EnlistmentFullInformation enumeration tidak digunakan dengan ZwQueryInformationEnlistment.

[out] EnlistmentInformation

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima informasi yang ditentukan parameter EnlistmentInformationClass . Jika nilai parameter EnlistmentInformationClass adalah EnlistmentBasicInformation, jenis struktur buffer ini harus ENLISTMENT_BASIC_INFORMATION. Jika nilai parameter EnlistmentInformationClass adalah EnlistmentRecoveryInformation, jenis buffer ini harus cocok dengan jenis yang ditentukan pemanggil yang digunakan pemanggil saat disebut ZwSetInformationEnlistment.

[in] EnlistmentInformationLength

Panjangnya, dalam byte, dari buffer yang ditunjukkan parameter EnlistmentInformation .

[out, optional] ReturnLength

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima panjang, dalam byte, dari informasi yang ditulis KTM ke buffer EnlistmentInformation . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_OBJECT_TYPE_MISMATCH
Handel yang ditentukan bukan handel ke objek pendaftaran.
STATUS_INVALID_HANDLE
Handel objek tidak valid.
STATUS_INVALID_INFO_CLASS
Nilai parameter EnlistmentInformationClass tidak valid.
STATUS_INFO_LENGTH_MISMATCH
Nilai parameter EnlistmentInformationLength tidak valid.
STATUS_ACCESS_DENIED
Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran.
 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Manajer sumber daya dapat memanggil ZwSetInformationEnlistment untuk mengatur informasi pemulihan khusus pendaftaran untuk objek pendaftaran lalu memanggil ZwQueryInformationEnlistment untuk mengambil informasi pemulihan.

Untuk informasi selengkapnya tentang ZwQueryInformationEnlistment, lihat Menangani Operasi Pemulihan.

Penelepon ZwQueryInformationEnlistment harus berjalan di IRQL = PASSIVE_LEVEL.

NtQueryInformationEnlistment dan ZwQueryInformationEnlistment adalah dua versi dari rutinitas Layanan Sistem Asli Windows 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 menginterpretasikan 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

ENLISTMENT_BASIC_INFORMATION

ENLISTMENT_INFORMATION_CLASS

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateEnlistment

ZwOpenEnlistment

ZwSetInformationEnlistment