Fungsi NtCommitTransaction (wdm.h)

Artikel
02/27/2024

Rutinitas ZwCommitTransaction memulai operasi penerapan untuk transaksi tertentu.

Sintaks

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

Parameter

[in] TransactionHandle

Handel ke objek transaksi. Komponen Anda menerima handel ini dari ZwCreateTransaction atau ZwOpenTransaction. Handel harus memiliki akses TRANSACTION_COMMIT ke objek.

[in] Wait

Nilai Boolean yang ditetapkan pemanggil ke TRUE untuk operasi sinkron atau FALSE untuk operasi asinkron. Jika parameter ini TRUE, panggilan akan kembali setelah operasi penerapan selesai.

Nilai kembali

ZwCommitTransaction 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 untuk parameter TransactionHandle bukan handel ke objek transaksi.
STATUS_INVALID_HANDLE	Handel objek transaksi yang ditentukan tidak valid.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek transaksi.
STATUS_TRANSACTION_SUPERIOR_EXISTS	Pemanggil tidak dapat melakukan transaksi karena ada manajer transaksi yang unggul .
STATUS_TRANSACTION_ALREADY_ABORTED	Transaksi tidak dapat dilakukan karena telah digulung balik.
STATUS_TRANSACTION_ALREADY_COMMITTED	Transaksi sudah dilakukan.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Operasi penerapan untuk transaksi ini telah dimulai.
STATUS_PENDING	Pemberitahuan penerapan telah diantrekan ke manajer sumber daya, dan pemanggil menentukan FALSE untuk parameter Tunggu .

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Untuk informasi selengkapnya tentang bagaimana klien transaksi harus menggunakan rutinitas ZwCommitTransaction , lihat Membuat Klien Transaksional.

Untuk informasi selengkapnya tentang operasi penerapan, lihat Menangani Operasi Penerapan.

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

TmCommitTransaction

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateTransaction

ZwOpenTransaction

Bagikan melalui