Fungsi TmRecoverTransactionManager (wdm.h)

  • Artikel

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

Sintaks

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

Parameter

[in] Tm

Penunjuk ke objek manajer transaksi. Untuk mendapatkan pointer ini, komponen TPS Anda harus memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang panggilan sebelumnya ke ZwCreateTransactionManager atau ZwOpenTransactionManager yang disediakan.

[in] TargetVirtualClock

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

Nilai kembali

TmRecoverTransactionManager mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_NOT_IMPLEMENTED
 Untuk Windows Vista, pemanggil menentukan nilai non-NULL untuk parameter TargetVirtualClock .
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 TmRecoverTransactionManager adalah versi berbasis pointer dari rutinitas ZwRecoverTransactionManager .

Memanggil TmRecoverTransactionManager dengan nilai parameter TargetVirtualClockNULL secara fungsional setara dengan memanggil ZwRecoverTransactionManager. Memanggil TmRecoverTransactionManager dengan nilai parameter TargetVirtualClocknon-NULL secara fungsional setara dengan memanggil ZwRollforwardTransactionManager.

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

Untuk informasi tentang kapan harus menggunakan rutinitas TmXxx KTM alih-alih rutinitas ZwXxx , lihat Menggunakan Rutinitas TmXxx.

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

Lihat juga

ZwRecoverTransactionManager

ZwRollforwardTransactionManager