Fungsi NtRecoverTransactionManager (wdm.h)

ZwRecoverTransactionManager rutin membangun kembali status objek manajer transaksi (termasuk semua transaksi, pendaftaran, dan manajer sumber daya) dari informasi pemulihan yang ada di aliran log.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Parameter

[in] TransactionManagerHandle

Handel ke objek manajer transaksi yang diperoleh oleh panggilan sebelumnya ke ZwCreateTransactionManager atau ZwOpenTransactionManager. Handel harus memiliki akses TRANSACTIONMANAGER_RECOVER ke objek .

Nilai kembali

ZwRecoverTransactionManager 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 manajer transaksi.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi.
STATUS_TM_VOLATILE	Objek manajer transaksi volatil dan, oleh karena itu, transaksinya tidak dapat dipulihkan.
STATUS_UNSUCCESSFUL	Objek manajer transaksi tidak dalam keadaan yang memungkinkan pemulihan.

 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas ZwRecoverTransactionManager mencoba merekonstruksi status objek manajer transaksi, termasuk semua transaksi, pendaftaran, dan manajer sumber daya, dari informasi pemulihan yang ada di aliran log objek, dimulai pada area hidupkan ulang terakhir yang dibuat KTM dan berakhir di akhir aliran.

Untuk memulihkan hingga waktu virtual tertentu, gunakan rutinitas ZwRollforwardTransactionManager alih-alih ZwRecoverTransactionManager.

Komponen TPS Anda harus memanggil ZwRecoverTransactionManager setelah disebut ZwCreateTransactionManager atau ZwOpenTransactionManager.

Untuk informasi selengkapnya tentang operasi pemulihan, lihat Menangani Operasi Pemulihan.

NtRecoverTransactionManager dan ZwRecoverTransactionManager 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
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Lihat juga

TmRecoverTransactionManager

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRollforwardTransactionManager