GetThreadInformation-Funktion (processthreadsapi.h)
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 |