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 |