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.

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

Siehe auch

GetProcessInformation, SetThreadInformation