Fungsi TmRequestOutcomeEnlistment (wdm.h)

Artikel
02/27/2024

Rutinitas TmRequestOutcomeEnlistment meminta KTM untuk mencoba memberikan hasil segera (penerapan atau pembatalan) untuk transaksi yang terkait dengan pendaftaran tertentu.

Sintaks

NTSTATUS TmRequestOutcomeEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] Enlistment

Penunjuk ke objek pendaftaran. Komponen Anda dapat menerima pointer ini sebagai input ke rutinitas panggilan balik ResourceManagerNotification . Atau, komponen Anda dapat memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang disediakan panggilan sebelumnya ke ZwCreateEnlistment, TmCreateEnlistment, atau ZwOpenEnlistment .

[in] TmVirtualClock

Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

TmRequestOutcomeEnlistment mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan nilai berikut:

Menampilkan kode	Deskripsi
STATUS_TRANSACTION_REQUEST_NOT_VALID	Pendaftaran yang ditentukan adalah pendaftaran yang unggul.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas TmRequestOutcomeEnlistment meminta KTM untuk mencoba memberikan hasil segera (hasil) untuk transaksi. Manajer sumber daya dapat memanggil TmRequestOutcomeEnlistment setelah disebut TmPrepareComplete atau ZwPrepareComplete, jika kemudian menemukan bahwa itu tidak dapat menunggu hasil karena, misalnya, penghapusan mendadak disk telah terjadi. KTM mungkin dapat memaksa putar kembali jika semua manajer sumber daya belum menyelesaikan operasi persiapan mereka.

Untuk informasi tentang kapan harus menggunakan rutinitas TmXxx KTM alih-alih rutinitas ZwXxx , lihat Menggunakan Rutinitas TmXxx.

Untuk informasi selengkapnya tentang TmCreateEnlistment, lihat Membuat Resource Manager.

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, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL