Fungsi NtSetInformationEnlistment (wdm.h)

Artikel
08/08/2023

Rutinitas ZwSetInformationEnlistment menetapkan informasi untuk objek pendaftaran tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

Parameter

[in] EnlistmentHandle

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

[in] EnlistmentInformationClass

Nilai enumerasi berjenis ENLISTMENT_INFORMATION_CLASS yang menentukan jenis informasi yang akan ditetapkan. Nilai ini harus EnlistmentRecoveryInformation.

Nilai EnlistmentBasicInformation dan EnlistmentFullInformation enumeration tidak digunakan dengan ZwSetInformationEnlistment.

[in] EnlistmentInformation

Penunjuk ke buffer yang dialokasikan penelepon yang berisi informasi pemulihan yang ditentukan penelepon untuk pendaftaran.

[in] EnlistmentInformationLength

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

Nilai kembali

ZwSetInformationEnlistment 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 menggunakan rutinitas ZwSetInformationEnlistment untuk mengatur informasi pemulihan untuk pendaftaran. KTM menulis informasi pemulihan ke aliran log, dan manajer sumber daya dapat memanggil ZwQueryInformationEnlistment untuk membaca informasi ini dari aliran log kapan saja.

Setiap panggilan berikutnya ke ZwSetInformationEnlistment menghapus informasi pemulihan yang ditentukan panggilan sebelumnya sebelum menyimpan informasi pemulihan baru.

Untuk informasi selengkapnya tentang cara menggunakan ZwSetInformationEnlistment, lihat Menggunakan Aliran Log dengan KTM.

NtSetInformationEnlistment dan ZwSetInformationEnlistment 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 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_INFORMATION_CLASS

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment

Bagikan melalui