OpenThread, fonction (processthreadsapi.h)

Article
03/01/2024

Ouvre un objet thread existant.

Syntaxe

HANDLE OpenThread(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwThreadId
);

Paramètres

[in] dwDesiredAccess

Accès à l’objet thread. Ce droit d’accès est vérifié par rapport au descripteur de sécurité pour le thread. Ce paramètre peut être un ou plusieurs des droits d’accès aux threads.

Si l’appelant a activé le privilège SeDebugPrivilege, l’accès demandé est accordé quel que soit le contenu du descripteur de sécurité.

[in] bInheritHandle

Si cette valeur est TRUE, les processus créés par ce processus héritent du handle. Sinon, les processus n’héritent pas de ce handle.

[in] dwThreadId

Identificateur du thread à ouvrir.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle ouvert pour le thread spécifié.

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

Remarques

Le handle retourné par OpenThread peut être utilisé dans n’importe quelle fonction qui nécessite un handle pour un thread, comme les fonctions d’attente, à condition que vous demandiez les droits d’accès appropriés. Le handle n’a accès à l’objet thread que dans la mesure où il a été spécifié dans le paramètre dwDesiredAccess .

Lorsque vous avez terminé avec le handle, veillez à le fermer à l’aide de la fonction CloseHandle .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll