Fungsi ZwRollbackTransaction (wdm.h)

  • Artikel

Rutinitas ZwRollbackTransaction memulai operasi putar kembali untuk transaksi tertentu.

Sintaks

NTSYSCALLAPI NTSTATUS ZwRollbackTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

Parameter

[in] TransactionHandle

Handel ke objek transaksi yang diperoleh oleh panggilan sebelumnya ke ZwCreateTransaction atau ZwOpenTransaction. Handel harus memiliki akses TRANSACTION_ROLLBACK ke objek.

[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

ZwRollbackTransaction 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 parameter TransactionHandle bukan handel ke objek transaksi.
STATUS_INVALID_HANDLE
 Handel objek tidak valid.
STATUS_ACCESS_DENIED
 Pemanggil tidak memiliki akses yang sesuai ke objek transaksi.
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 pembatalan telah diantrekan ke manajer sumber daya, dan pemanggil menentukan FALSE untuk parameter Tunggu .
 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Untuk informasi selengkapnya tentang ZwRollbackTransaction, lihat Menangani Operasi Putar Kembali.

NtRollbackEnlistment dan ZwRollbackEnlistment 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 menafsirkan 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(storport), PowerIrpDDis(wdm)

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction