GetThreadInformation, fonction (processthreadsapi.h)

Article
03/01/2024

Récupère des informations sur le thread spécifié.

Syntaxe

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

Paramètres

[in] hThread

Handle pour le thread. Le handle doit disposer de droits d’accès THREAD_QUERY_INFORMATION. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

[in] ThreadInformationClass

Classe d’informations à récupérer. Cette valeur peut être ThreadMemoryPriority, ThreadAbsoluteCpuPriority ou ThreadDynamicCodePolicy.

Notes

ThreadDynamicCodePolicy est pris en charge dans Windows Server 2016 et versions ultérieures, Windows 10 LTSB 2016 et versions ultérieures, et Windows 10 version 1607 et ultérieure.

ThreadInformation

Pointeur vers une structure pour recevoir le type d’informations spécifié par le paramètre ThreadInformationClass .

Si le paramètre ThreadInformationClass est ThreadMemoryPriority, ce paramètre doit pointer vers une structure MEMORY_PRIORITY_INFORMATION .

Si le paramètre ThreadInformationClass est ThreadAbsoluteCpuPriority, ce paramètre doit pointer vers un long.

Si le paramètre ThreadInformationClass est ThreadDynamicCodePolicy, ce paramètre doit pointer vers un DWORD.

[in] ThreadInformationSize

Taille en octets de la structure spécifiée par le paramètre ThreadInformation .

Si le paramètre ThreadInformationClass est ThreadMemoryPriority, ce paramètre doit être sizeof(MEMORY_PRIORITY_INFORMATION).

Si le paramètre ThreadInformationClass est ThreadAbsoluteCpuPriority, ce paramètre doit être sizeof(LONG).

Si le paramètre ThreadInformationClass est ThreadDynamicCodePolicy, ce paramètre doit être sizeof(DWORD).

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetProcessInformation, SetThreadInformation

Partager via