Fungsi NtCommitEnlistment (wdm.h)
Rutinitas ZwCommitEnlistment memulai operasi penerapan untuk transaksi pendaftaran tertentu.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtCommitEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Parameter
[in] EnlistmentHandle
Handel ke objek pendaftaran yang diperoleh oleh panggilan sebelumnya ke ZwCreateEnlistment atau ZwOpenEnlistment. Objek harus mewakili pendaftaran yang unggul dan handel harus memiliki akses ENLISTMENT_SUPERIOR_RIGHTS ke objek.
[in, optional] TmVirtualClock
Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
ZwCommitEnlistment mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Handel yang ditentukan bukan handel ke objek pendaftaran. |
|
Handel objek tidak valid. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran. |
|
Pemanggil bukan manajer transaksi yang unggul untuk pendaftaran. |
|
Penelepon tidak mendaftar untuk menerima pemberitahuan TRANSACTION_NOTIFY_COMMIT_COMPLETE. |
|
Transaksi pendaftaran tidak dalam keadaan yang memungkinkannya diterapkan. |
|
Operasi penerapan untuk transaksi ini telah dimulai. |
|
Transaksi tidak dapat dilakukan karena telah digulung balik. |
Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.
Keterangan
Hanya manajer transaksi unggul yang dapat memanggil ZwCommitEnlistment.
Pemanggil ZwCommitEnlistment harus mendaftar untuk menerima pemberitahuan TRANSACTION_NOTIFY_COMMIT_COMPLETE.
Rutinitas ZwCommitEnlistment menyebabkan KTM mengirim pemberitahuan TRANSACTION_NOTIFY_COMMIT ke semua manajer sumber daya yang telah mendaftar dalam transaksi.
Untuk informasi selengkapnya tentang ZwCommitEnlistment, lihat Membuat Manajer Transaksi Superior dan 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 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