Fungsi NtQueryInformationTransactionManager (wdm.h)
Rutinitas ZwQueryInformationTransactionManager mengambil informasi tentang objek manajer transaksi tertentu.
Sintaks
__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 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
[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 |
---|---|
|
Nilai parameter TransactionManagerInformationClass tidak valid. |
|
Panjang buffer yang ditentukan oleh parameter TransactionManagerInformationLength salah. |
|
Handel yang ditentukan bukan handel ke objek manajer transaksi. |
|
Handel objek tidak valid. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi. |
|
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, PowerIrpDDis |
Lihat juga
TRANSACTIONMANAGER_BASIC_INFORMATION
TRANSACTIONMANAGER_INFORMATION_CLASS
TRANSACTIONMANAGER_LOGPATH_INFORMATION
TRANSACTIONMANAGER_LOG_INFORMATION
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli