Funzione GetThreadInformation (processthreadsapi.h)

Articolo
03/13/2024

Recupera informazioni sul thread specificato.

Sintassi

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

Parametri

[in] hThread

Handle per il thread. L'handle deve avere diritti di accesso THREAD_QUERY_INFORMATION. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.

[in] ThreadInformationClass

Classe di informazioni da recuperare. Questo valore può essere ThreadMemoryPriority, ThreadAbsoluteCpuPriority o ThreadDynamicCodePolicy.

Nota

ThreadDynamicCodePolicy è supportato in Windows Server 2016 e versioni successive, Windows 10 LTSB 2016 e versioni successive e Windows 10 versione 1607 e versioni successive.

ThreadInformation

Puntatore a una struttura per ricevere il tipo di informazioni specificate dal parametro ThreadInformationClass .

Se il parametro ThreadInformationClass è ThreadMemoryPriority, questo parametro deve puntare a una struttura MEMORY_PRIORITY_INFORMATION .

Se il parametro ThreadInformationClass è ThreadAbsoluteCpuPriority, questo parametro deve puntare a long.

Se il parametro ThreadInformationClass è ThreadDynamicCodePolicy, questo parametro deve puntare a una DWORD.

[in] ThreadInformationSize

Dimensioni in byte della struttura specificata dal parametro ThreadInformation .

Se il parametro ThreadInformationClass è ThreadMemoryPriority, questo parametro deve essere sizeof(MEMORY_PRIORITY_INFORMATION).

Se il parametro ThreadInformationClass è ThreadAbsoluteCpuPriority, questo parametro deve essere sizeof(LONG).

Se il parametro ThreadInformationClass è ThreadDynamicCodePolicy, questo parametro deve essere sizeof(DWORD).

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetProcessInformation, SetThreadInformation

Condividi tramite