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 |
---|---|
|
Handel yang ditentukan bukan handel ke objek manajer transaksi. |
|
Handel objek tidak valid. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi. |
|
Objek manajer transaksi volatil dan, oleh karena itu, transaksinya tidak dapat dipulihkan. |
|
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
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli