Fungsi ZwRecoverResourceManager (wdm.h)

Artikel
08/08/2023

Rutinitas ZwRecoverResourceManager mencoba memulihkan transaksi yang terkait dengan setiap pendaftaran objek manajer sumber daya tertentu.

Sintaks

NTSYSCALLAPI NTSTATUS ZwRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

Parameter

[in] ResourceManagerHandle

Handel ke objek resource manager 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 mengirim 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 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, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL