Поделиться через


Функция GetThreadInformation (processthreadsapi.h)

Извлекает сведения об указанном потоке.

Синтаксис

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

Параметры

[in] hThread

Дескриптор потока. Дескриптор должен иметь права доступа THREAD_QUERY_INFORMATION. Дополнительные сведения см. в разделе Безопасность потоков и права доступа.

[in] ThreadInformationClass

Класс извлекаемой информации. Это значение может быть ThreadMemoryPriority, ThreadAbsoluteCpuPriority или ThreadDynamicCodePolicy.

Примечание

ThreadDynamicCodePolicy поддерживается в Windows Server 2016 и более поздних версиях, Windows 10 LTSB 2016 и более поздних версий, а также Windows 10 версии 1607 и более поздних версий.

ThreadInformation

Указатель на структуру для получения сведений типа, заданного параметром ThreadInformationClass .

Если параметр ThreadInformationClass имеет значение ThreadMemoryPriority, этот параметр должен указывать на MEMORY_PRIORITY_INFORMATION структуру.

Если параметр ThreadInformationClass имеет значение ThreadAbsoluteCpuPriority, этот параметр должен указывать на LONG.

Если параметр ThreadInformationClass имеет значение ThreadDynamicCodePolicy, этот параметр должен указывать на DWORD.

[in] ThreadInformationSize

Размер в байтах структуры, заданной параметром ThreadInformation .

Если параметр ThreadInformationClass имеет значение ThreadMemoryPriority, этот параметр должен иметь значение sizeof(MEMORY_PRIORITY_INFORMATION).

Если параметр ThreadInformationClass имеет значение ThreadAbsoluteCpuPriority, этот параметр должен иметь значение sizeof(LONG).

Если параметр ThreadInformationClass имеет значение ThreadDynamicCodePolicy, этот параметр должен иметь значение sizeof(DWORD).

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header processthreadsapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetProcessInformation, SetThreadInformation