_endthread, _endthreadex
Met fin à un thread créé par _beginthread ou _beginthreadex, respectivement.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.
void _endthread( void );
void _endthreadex(
unsigned retval
);
Paramètres
- retval
Code de sortie du thread.
Notes
Vous pouvez appeler _endthread ou _endthreadex explicitement pour terminer un thread ; toutefois, _endthread ou _endthreadex est appelée automatiquement lorsque le thread retourne de la routine passé comme paramètre à _beginthread ou à _beginthreadex.En effectuant un thread avec un appel à endthread ou aux permet d' _endthreadex que la récupération appropriée des ressources allouées pour le thread.
[!REMARQUE]
Pour un exécutable lié avec Libcmt.lib, n'appelez pas l'API Win32 ExitThread ; cela empêché le système runtime de libérer les ressources allouées._endthread et la récupération d' _endthreadex allouée thread les ressources puis appelez ExitThread.
_endthread ferme automatiquement le handle du thread.(Ce comportement diffère de l'API Win32 ExitThread .) Par conséquent, lorsque vous utilisez _beginthread et _endthread, ne fermez pas explicitement le handle du thread en appelant l'API Win32 CloseHandle .
Comme l'API Win32 ExitThread, _endthreadex ne ferme pas le handle du thread.Par conséquent, lorsque vous utilisez _beginthreadex et _endthreadex, vous devez fermer le handle du thread en appelant l'API Win32 CloseHandle .
[!REMARQUE]
_endthread et _endthreadex entraînent des destructeurs C++ en attente dans le thread de ne pas être appelés.
Configuration requise
Fonction |
En-tête requis |
|---|---|
_endthread |
<process.h> |
_endthreadex |
<process.h> |
Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.
Bibliothèques
Versions multithread d' Bibliothèques runtime C uniquement.
Exemple
Consultez l'exemple pour _beginthread.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' Exemples d'appel de code non managé.