Fungsi TmRollbackTransaction (wdm.h)

  • Artikel

Rutinitas TmRollbackTransaction memulai operasi pembatalan untuk transaksi tertentu.

Sintaks

NTSTATUS TmRollbackTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

Parameter

[in] Transaction

Penunjuk ke objek transaksi. Untuk mendapatkan pointer ini, komponen Anda harus memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang panggilan sebelumnya ke ZwCreateTransaction atau ZwOpenTransaction yang disediakan.

[in] Wait

Nilai Boolean yang ditetapkan pemanggil ke TRUE untuk operasi sinkron atau FALSE untuk operasi asinkron. Jika parameter ini diatur ke TRUE, panggilan tidak akan kembali hingga operasi pembatalan selesai.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_TRANSACTION_ALREADY_COMMITTED
 Transaksi tidak dapat digulung balik karena telah dilakukan.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 Transaksi belum dilakukan tetapi statusnya saat ini tidak mengizinkan pembatalan.
STATUS_PENDING
 Pemberitahuan putar kembali telah diantrekan ke manajer sumber daya, dan pemanggil menentukan FALSE untuk parameter Tunggu .
 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas TmRollbackTransaction adalah versi berbasis pointer dari rutinitas ZwRollbackTransaction .

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

ObReferenceObjectByHandle

ZwCreateTransaction

ZwOpenTransaction

ZwRollbackTransaction