Fungsi NtRollbackTransaction (wdm.h)
Rutinitas ZwRollbackTransaction memulai operasi putar kembali untuk transaksi tertentu.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackTransaction(
[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 |
---|---|
|
Handel yang ditentukan parameter TransactionHandle bukan handel ke objek transaksi. |
|
Handel objek tidak valid. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek transaksi. |
|
Transaksi tidak dapat digulung balik karena telah dilakukan. |
|
Transaksi belum dilakukan tetapi statusnya saat ini tidak mengizinkan pembatalan. |
|
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, PowerIrpDDis |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk