Fungsi NtQueryInformationThread (winternl.h)
[NtQueryInformationThread dapat diubah atau tidak tersedia di versi Windows yang akan datang. Aplikasi harus menggunakan fungsi alternatif yang tercantum dalam topik ini.]
Mengambil informasi tentang utas yang ditentukan.
Sintaks
__kernel_entry NTSTATUS NtQueryInformationThread(
[in] HANDLE ThreadHandle,
[in] THREADINFOCLASS ThreadInformationClass,
[in, out] PVOID ThreadInformation,
[in] ULONG ThreadInformationLength,
[out, optional] PULONG ReturnLength
);
Parameter
[in] ThreadHandle
Handel ke utas tentang informasi mana yang diminta.
[in] ThreadInformationClass
Jika parameter ini adalah nilai ThreadIsIoPending dari enumerasi THREADINFOCLASS , fungsi menentukan apakah utas memiliki operasi I/O yang tertunda.
Gunakan fungsi publik GetThreadIOPendingFlag sebagai gantinya untuk mendapatkan informasi ini.
Jika parameter ini adalah nilai ThreadQuerySetWin32StartAddress dari enumerasi THREADINFOCLASS , fungsi mengembalikan alamat awal utas. Perhatikan bahwa pada versi Windows sebelum Windows Vista, alamat mulai yang dikembalikan hanya dapat diandalkan sebelum utas mulai berjalan.
Jika parameter ini adalah nilai ThreadSubsystemInformation dari enumerasi THREADINFOCLASS , fungsi mengambil nilai SUBSYSTEM_INFORMATION_TYPE yang menunjukkan jenis subsistem utas. Buffer yang ditunjukkan oleh parameter ThreadInformation harus cukup besar untuk menahan enumerasi SUBSYSTEM_INFORMATION_TYPE tunggal.
[in, out] ThreadInformation
Penunjuk ke buffer tempat fungsi menulis informasi yang diminta. Jika ThreadIsIoPending ditentukan untuk parameter ThreadInformationClass , buffer ini harus cukup besar untuk menahan nilai ULONG , yang menunjukkan apakah utas yang ditentukan memiliki permintaan I/O tertunda. Jika nilai ini sama dengan nol, maka tidak ada operasi I/O yang tertunda; jika tidak, jika nilainya bukan nol, maka utas memang memiliki operasi I/O yang tertunda.
Gunakan fungsi publik GetThreadIOPendingFlag sebagai gantinya untuk mendapatkan informasi ini.
Jika ThreadQuerySetWin32StartAddress ditentukan untuk parameter ThreadInformationClass , buffer ini harus cukup besar untuk menyimpan nilai PVOID, yang merupakan alamat awal utas.
[in] ThreadInformationLength
Ukuran buffer yang ditunjukkan oleh parameter ThreadInformation , dalam byte.
[out, optional] ReturnLength
Penunjuk ke variabel di mana fungsi mengembalikan ukuran informasi yang diminta. Jika fungsi berhasil, ini adalah ukuran informasi yang ditulis ke buffer yang ditunjukkan oleh parameter ThreadInformation , tetapi jika buffer terlalu kecil, ini adalah ukuran minimum buffer yang diperlukan untuk menerima informasi dengan sukses.
Mengembalikan nilai
Mengembalikan keberhasilan NTSTATUS atau kode kesalahan.
Formulir dan signifikansi kode kesalahan NTSTATUS tercantum dalam file header Ntstatus.h yang tersedia di DDK, dan dijelaskan dalam dokumentasi DDK di bawah Kernel-Mode Arsitektur Driver / Panduan Desain / Teknik Pemrograman Driver / Kesalahan Pengelogan.
Keterangan
Fungsi NtQueryInformationThread bersifat internal untuk sistem operasi dan dapat berubah dari satu rilis Windows ke rilis lainnya. Untuk mempertahankan kompatibilitas aplikasi Anda, lebih baik menggunakan fungsi publik yang disebutkan sebelumnya sebagai gantinya.
Jika Anda menggunakan NtQueryInformationThread, akses fungsi melalui penautan dinamis run-time. Ini memberi kode Anda kesempatan untuk merespons dengan baik jika fungsi telah diubah atau dihapus dari sistem operasi. Namun, perubahan tanda tangan mungkin tidak dapat dideteksi.
Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Ntdll.dll.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | winternl.h |
Pustaka | ntdll.lib |
DLL | ntdll.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk