Partager via


OpenThread, fonction (processthreadsapi.h)

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

Voir aussi

CloseHandle

GetExitCodeThread

GetThreadContext

Fonctions de processus et de thread

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Threads