Fungsi NtQueryInformationTransactionManager (wdm.h)

Artikel
07/02/2025

Rutinitas ZwQueryInformationTransactionManager mengambil informasi tentang objek manajer transaksi tertentu.

Sintaksis

C++

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationTransactionManager(
  [in]            HANDLE                               TransactionManagerHandle,
  [in]            TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass,
  [out]           PVOID                                TransactionManagerInformation,
  [in]            ULONG                                TransactionManagerInformationLength,
  [out, optional] PULONG                               ReturnLength
);

Parameter

[in] TransactionManagerHandle

Handel ke objek manajer transaksi yang diperoleh melalui panggilan sebelumnya ke ZwCreateTransactionManager atau ZwOpenTransactionManager. Handel harus memiliki akses TRANSACTIONMANAGER_QUERY_INFORMATION ke objek.

[in] TransactionManagerInformationClass

Nilai enumerasi TRANSACTIONMANAGER_INFORMATION_CLASS-typed yang menentukan informasi yang akan diperoleh. Nilai ini harus salah satu dari yang berikut ini:

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

Nilai TransactionManagerOnlineProbeInformation enumeration tidak digunakan dengan ZwQueryInformationTransactionManager.

[out] TransactionManagerInformation

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima informasi yang ditentukan parameter TransactionManagerInformationClass. Jenis struktur buffer harus TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATION, atau TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

Panjang, dalam byte, dari buffer yang transactionManagerInformation parameter menunjuk ke, termasuk panjang elemen array tambahan yang telah dialokasikan pemanggil untuk menerima informasi.

[out, optional] ReturnLength

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima panjang, dalam byte, dari informasi yang ditulis KTM ke transactionManagerInformation buffer. Parameter ini bersifat opsional dan dapat NULL.

Mengembalikan nilai

ZwQueryInformationTransactionManager mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Mengembalikan kode	Deskripsi
STATUS_INVALID_INFO_CLASS	Nilai parameter TransactionManagerInformationClass tidak valid.
STATUS_INFO_LENGTH_MISMATCH	Panjang buffer yang ditentukan oleh parameter TransactionManagerInformationLength salah.
STATUS_OBJECT_TYPE_MISMATCH	Handel yang ditentukan bukan handel ke objek manajer transaksi.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi.
STATUS_BUFFER_TOO_SMALL	Buffer yang ditentukan oleh parameter TransactionManagerInformation terlalu kecil.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Komentar

Untuk informasi selengkapnya tentang cara menggunakan ZwQueryInformationTransactionManager, lihat Menggunakan Aliran Log dengan KTM.

NtQueryInformationTransactionManager dan ZwQueryInformationTransactionManager adalah dua versi dari rutinitas Windows Native System Services yang sama.

Untuk panggilan dari driver mode kernel, NtXxx dan ZwXxx versi rutin Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara NtXxx dan versi ZwXxx rutin, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Platform Target	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
aturan kepatuhan DDI	HwStorPortProhibitedDDIs, PowerIrpDDis