Fungsi NtRecoverEnlistment (wdm.h)
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 |
---|---|
|
Handel yang ditentukan bukan handel ke objek pendaftaran. |
|
Handel objek tidak valid. |
|
Transaksi atau pendaftarannya tidak dalam status yang benar. |
|
KTM telah menambahkan pemberitahuan penerapan, pembatalan, atau keraguan ke antrean pemberitahuan manajer sumber daya, dan manajer sumber daya tidak menggunakan rutinitas panggilan balik ResourceManagerNotification . |
|
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 |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk