GetThreadInformation function (processthreadsapi.h)

Retrieves information about the specified thread.

Syntax

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

Parameters

[in] hThread

A handle to the thread. The handle must have THREAD_QUERY_INFORMATION access rights. For more information, see Thread Security and Access Rights.

[in] ThreadInformationClass

The class of information to retrieve. This value can be ThreadMemoryPriority, ThreadAbsoluteCpuPriority or ThreadDynamicCodePolicy.

ThreadInformation

Pointer to a structure to receive the type of information specified by the ThreadInformationClass parameter.

If the ThreadInformationClass parameter is ThreadMemoryPriority, this parameter must point to a MEMORY_PRIORITY_INFORMATION structure.

If the ThreadInformationClass parameter is ThreadAbsoluteCpuPriority, this parameter must point to a LONG.

If the ThreadInformationClass parameter is ThreadDynamicCodePolicy, this parameter must point to a DWORD.

[in] ThreadInformationSize

The size in bytes of the structure specified by the ThreadInformation parameter.

If the ThreadInformationClass parameter is ThreadMemoryPriority, this parameter must be sizeof(MEMORY_PRIORITY_INFORMATION).

If the ThreadInformationClass parameter is ThreadAbsoluteCpuPriority, this parameter must be sizeof(LONG).

If the ThreadInformationClass parameter is ThreadDynamicCodePolicy, this parameter must be sizeof(DWORD).

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

See also

GetProcessInformation, SetThreadInformation