FreeLibraryAndExitThread, fonction (libloaderapi.h)
Décrémente le nombre de références d’une bibliothèque de liens dynamiques (DLL) chargée, puis appelle ExitThread pour arrêter le thread appelant. La fonction ne retourne pas.
Syntaxe
void FreeLibraryAndExitThread(
[in] HMODULE hLibModule,
[in] DWORD dwExitCode
);
Paramètres
[in] hLibModule
Handle pour le module DLL dont les références comptent les décrémentations de la fonction. La fonction LoadLibrary ou GetModuleHandleEx retourne ce handle.
N’appelez pas cette fonction avec un handle retourné par la fonction GetModuleHandleEx (avec l’indicateur GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT) ou la fonction GetModuleHandle , car elles ne conservent pas de nombre de références pour le module.
[in] dwExitCode
Code de sortie du thread appelant.
Valeur de retour
None
Remarques
La fonction FreeLibraryAndExitThread permet aux threads qui s’exécutent dans une DLL de libérer en toute sécurité la DLL dans laquelle ils s’exécutent et de s’arrêter eux-mêmes. S’ils appelaient FreeLibrary et ExitThread séparément, une condition de race existerait. La bibliothèque peut être déchargée avant l’appel de ExitThread .
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 | libloaderapi.h (inclure Windows.h) |
Bibliothèque | Kernel32.lib |
DLL | Kernel32.dll |