Fungsi NtRecoverEnlistment (wdm.h)

Artikel
02/27/2024

Rutinitas ZwRecoverEnlistment memulai operasi pemulihan untuk transaksi yang terkait dengan pendaftaran tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverEnlistment(
  [in]           HANDLE EnlistmentHandle,
  [in, optional] PVOID  EnlistmentKey
);

Parameter

[in] EnlistmentHandle

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

[in, optional] EnlistmentKey

Penunjuk ke nilai kunci pendaftaran yang sebelumnya ditentukan manajer sumber daya sebagai parameter EnlistmentKey ke ZwCreateEnlistment. Parameter ini bersifat opsional dan dapat berupa NULL jika manajer sumber daya tidak memberikan kunci pendaftaran saat disebut ZwCreateEnlistment.

Nilai kembali

ZwRecoverEnlistment 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_TRANSACTION_REQUEST_NOT_VALID	Transaksi atau pendaftarannya tidak dalam status yang benar.
STATUS_PENDING	KTM telah menambahkan pemberitahuan penerapan, pembatalan, atau keraguan ke antrean pemberitahuan manajer sumber daya, dan manajer sumber daya tidak menggunakan rutinitas panggilan balik ResourceManagerNotification .
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Setelah manajer sumber daya memanggil ZwRecoverEnlistment, KTM memberikan pemberitahuan TRANSACTION_NOTIFY_COMMIT, TRANSACTION_NOTIFY_ROLLBACK, atau TRANSACTION_NOTIFY_INDOUBT untuk pendaftaran. Oleh karena itu, kecuali manajer sumber daya menggunakan rutinitas panggilan balik ResourceManagerNotification , manajer sumber daya harus segera memanggil ZwGetNotificationResourceManager jika ZwRecoverEnlistment mengembalikan STATUS_SUCCESS atau STATUS_PENDING.

Untuk informasi selengkapnya tentang ZwRecoverEnlistment, lihat Menangani Operasi Pemulihan.

NtRecoverEnlistment dan ZwRecoverEnlistment 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