Fungsi NtRecoverResourceManager (wdm.h)

Artikel
02/27/2024

Rutinitas ZwRecoverResourceManager mencoba memulihkan transaksi yang terkait dengan setiap pendaftaran objek resource manager tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

Parameter

[in] ResourceManagerHandle

Handel ke objek manajer sumber daya yang diperoleh oleh panggilan sebelumnya ke ZwCreateResourceManager atau ZwOpenResourceManager. Handel harus memiliki akses RESOURCEMANAGER_RECOVER ke objek.

Nilai kembali

ZwRecoverResourceManager 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 resource manager.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	Manajer transaksi yang terkait dengan resource manager yang ditentukan tidak tersedia.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek manajer sumber daya.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Saat manajer sumber daya memanggil ZwRecoverResourceManager, KTM mengirimkan pemberitahuan TRANSACTION_NOTIFY_RECOVER ke manajer sumber daya untuk setiap pendaftaran manajer sumber daya. (Jika pendaftaran adalah pendaftaran yang unggul, KTM mengirimkan TRANSACTION_NOTIFY_RECOVER_QUERY alih-alih TRANSACTION_NOTIFY_RECOVER.)

Pemberitahuan akhir yang dikirim KTM ke manajer sumber daya TRANSACTION_NOTIFY_LAST_RECOVER.

Untuk informasi selengkapnya tentang ZwRecoverResourceManager, lihat Menangani Operasi Pemulihan.

NtRecoverResourceManager dan ZwRecoverResourceManager 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, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL