GetThreadInformation-Funktion (processthreadsapi.h)

  • Artikel

Ruft Informationen zum angegebenen Thread ab.

Syntax

BOOL GetThreadInformation(
  [in] HANDLE                   hThread,
  [in] THREAD_INFORMATION_CLASS ThreadInformationClass,
       LPVOID                   ThreadInformation,
  [in] DWORD                    ThreadInformationSize
);

Parameter

[in] hThread

Ein Handle auf den Thread. Das Handle muss über THREAD_QUERY_INFORMATION Zugriffsrechte verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[in] ThreadInformationClass

Die Klasse der abzurufenden Informationen. Dieser Wert kann ThreadMemoryPriority, ThreadAbsoluteCpuPriority oder ThreadDynamicCodePolicy sein.

Hinweis

ThreadDynamicCodePolicy wird in Windows Server 2016 und neueren Versionen unterstützt, Windows 10 LTSB 2016 und höher sowie Windows 10 Version 1607 und höher.

ThreadInformation

Zeiger auf eine Struktur, um den vom ThreadInformationClass-Parameter angegebenen Informationstyp zu empfangen.

Wenn der ThreadInformationClass-ParameterThreadMemoryPriority ist, muss dieser Parameter auf eine MEMORY_PRIORITY_INFORMATION-Struktur verweisen.

Wenn der ThreadInformationClass-ParameterThreadAbsoluteCpuPriority ist, muss dieser Parameter auf einen LONG-Parameter verweisen.

Wenn der ThreadInformationClass-ParameterThreadDynamicCodePolicy ist, muss dieser Parameter auf ein DWORD verweisen.

[in] ThreadInformationSize

Die Größe der vom ThreadInformation-Parameter angegebenen Struktur in Byte.

Wenn der ThreadInformationClass-ParameterThreadMemoryPriority ist, muss dieser Parameter sein sizeof(MEMORY_PRIORITY_INFORMATION).

Wenn der ThreadInformationClass-ParameterThreadAbsoluteCpuPriority ist, muss dieser Parameter sein sizeof(LONG).

Wenn der ThreadInformationClass-ParameterThreadDynamicCodePolicy ist, muss dieser Parameter sein sizeof(DWORD).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (include Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetProcessInformation, SetThreadInformation