Fungsi GetThreadInformation (processthreadsapi.h)
Mengambil informasi tentang utas yang ditentukan.
Sintaks
BOOL GetThreadInformation(
[in] HANDLE hThread,
[in] THREAD_INFORMATION_CLASS ThreadInformationClass,
LPVOID ThreadInformation,
[in] DWORD ThreadInformationSize
);
Parameter
[in] hThread
Handel ke utas. Handel harus memiliki hak akses THREAD_QUERY_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.
[in] ThreadInformationClass
Kelas informasi yang akan diambil. Nilai ini dapat berupa ThreadMemoryPriority, ThreadAbsoluteCpuPriority atau ThreadDynamicCodePolicy.
Catatan
ThreadDynamicCodePolicy didukung di Windows Server 2016 dan yang lebih baru, Windows 10 LTSB 2016 dan yang lebih baru, dan Windows 10 versi 1607 dan yang lebih baru.
ThreadInformation
Arahkan ke struktur untuk menerima jenis informasi yang ditentukan oleh parameter ThreadInformationClass .
Jika parameter ThreadInformationClass adalah ThreadMemoryPriority, parameter ini harus menunjuk ke struktur MEMORY_PRIORITY_INFORMATION .
Jika parameter ThreadInformationClass adalah ThreadAbsoluteCpuPriority, parameter ini harus menunjuk ke LONG.
Jika parameter ThreadInformationClass adalah ThreadDynamicCodePolicy, parameter ini harus menunjuk ke DWORD.
[in] ThreadInformationSize
Ukuran dalam byte struktur yang ditentukan oleh parameter ThreadInformation .
Jika parameter ThreadInformationClass adalah ThreadMemoryPriority, parameter ini harus sizeof(MEMORY_PRIORITY_INFORMATION)
.
Jika parameter ThreadInformationClass adalah ThreadAbsoluteCpuPriority, parameter ini harus sizeof(LONG)
.
Jika parameter ThreadInformationClass adalah ThreadDynamicCodePolicy, parameter ini harus sizeof(DWORD)
.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | processthreadsapi.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |