Fungsi TmRecoverEnlistment (wdm.h)

Artikel
02/27/2024

Rutinitas TmRecoverEnlistment memulai operasi pemulihan untuk transaksi yang terkait dengan pendaftaran tertentu.

Sintaks

NTSTATUS TmRecoverEnlistment(
  [in] PKENLISTMENT Enlistment,
  [in] PVOID        EnlistmentKey
);

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] EnlistmentKey

Penunjuk ke nilai kunci pendaftaran yang sebelumnya ditentukan manajer sumber daya sebagai parameter EnlistmentKey ke ZwCreateEnlistment atau TmCreateEnlistment. Parameter ini bersifat opsional dan dapat berupa NULL jika manajer sumber daya tidak memberikan kunci pendaftaran ketika disebut ZwCreateEnlistment atau TmCreateEnlistment.

Nilai kembali

TmRecoverEnlistment 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 bukan handel ke objek pendaftaran.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Transaksi atau pendaftarannya tidak dalam status yang benar.
STATUS_PENDING	KTM telah menambahkan pemberitahuan penerapan, pembatalan, atau keraguan ke antrean pemberitahuan manajer sumber daya, dan manajer sumber daya tidak menggunakan rutinitas panggilan balik ResourceManagerNotification .

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas TmRecoverEnlistment adalah versi berbasis pointer dari rutinitas ZwRecoverEnlistment .

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

Untuk informasi selengkapnya tentang operasi pemulihan, lihat Menangani Operasi Pemulihan.

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