Fungsi NtRollforwardTransactionManager (wdm.h)

Artikel
02/27/2024

Rutinitas ZwRollforwardTransactionManager memulai operasi pemulihan untuk semua transaksi yang sedang berlangsung yang ditetapkan ke manajer transaksi tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtRollforwardTransactionManager(
  [in]           HANDLE         TransactionManagerHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

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 .

[in, optional] TmVirtualClock

Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL. Untuk informasi selengkapnya tentang parameter ini, lihat bagian Keterangan berikut.

Nilai kembali

ZwRollforwardTransactionManager 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 yang ditentukan tidak memiliki file log, sehingga pemulihan tidak tersedia.
STATUS_UNSUCCESSFUL	Objek manajer transaksi yang ditentukan dalam keadaan tidak terduga.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas ZwRollforwardTransactionManager memulihkan semua aktivitas yang dicatat yang ditemukan KTM dalam file log manajer transaksi, hingga dan termasuk nilai jam virtual yang disediakan parameter TmVirtualClock .

Komponen Anda dapat melintasi file log secara bertahap dengan memanggil ZwRollforwardTransactionManager secara berulang dan mengatur parameter VirtualClock ke nilai yang lebih tinggi sebelum setiap panggilan.

Jika parameter TmVirtualClock adalah NULL, memanggil ZwRollforwardTransactionManager setara dengan memanggil ZwRecoverTransactionManager.

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

NtRollforwardTransactionManager dan ZwRollforwardTransactionManager adalah dua versi dari rutinitas Windows Native System Services yang sama. Rutinitas NtRollforwardTransactionManager di kernel Windows tidak dapat diakses langsung oleh driver mode kernel. Namun, driver mode kernel dapat mengakses rutinitas ini secara tidak langsung dengan memanggil rutinitas ZwRollforwardTransactionManager .

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 Windows 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

TmRecoverTransactionManager

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRecoverTransactionManager

Bagikan melalui