Share via

Fungsi GetThreadInformation (processthreadsapi.h)

  • Artikel

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

Lihat juga

GetProcessInformation, SetThreadInformation