Fungsi ZwQueryInformationTransactionManager (wdm.h)

Artikel
02/27/2024

Rutinitas ZwQueryInformationTransactionManager mengambil informasi tentang objek manajer transaksi tertentu.

Sintaks

NTSYSCALLAPI NTSTATUS ZwQueryInformationTransactionManager(
  [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 oleh panggilan sebelumnya ke ZwCreateTransactionManager atau ZwOpenTransactionManager. Handel harus memiliki akses TRANSACTIONMANAGER_QUERY_INFORMATION ke objek .

[in] TransactionManagerInformationClass

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

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

Nilai TransactionManagerOnlineProbeInformation enumerasi 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

Panjangnya, dalam byte, dari buffer yang dialokasikan parameter TransactionManagerInformation , 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 buffer TransactionManagerInformation . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Menampilkan 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.

Keterangan

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

NtQueryInformationTransactionManager dan ZwQueryInformationTransactionManager adalah dua versi dari rutinitas Layanan Sistem Asli Windows yang sama.

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 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
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)