Fungsi ZwCommitTransaction (wdm.h)

  • Artikel

Rutinitas ZwCommitTransaction memulai operasi penerapan untuk transaksi tertentu.

Sintaks

NTSYSCALLAPI NTSTATUS ZwCommitTransaction(
  [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 menginterpretasikan 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(storport), PowerIrpDDis(wdm)

Lihat juga

TmCommitTransaction

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateTransaction

ZwOpenTransaction