TlsFree, fonction (processthreadsapi.h)
Libère un index de stockage local de thread (TLS), ce qui le rend disponible pour réutilisation.
Syntaxe
BOOL TlsFree(
[in] DWORD dwTlsIndex
);
Paramètres
[in] dwTlsIndex
Index TLS qui a été alloué par la fonction TlsAlloc .
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Windows Phone 8.1 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8.1 et versions ultérieures. Lorsqu’une application Windows Phone Store appelle cette fonction, elle est remplacée par un appel inline à FlsFree. Reportez-vous à FlsFree pour la documentation des fonctions.
Windows 8.1, Windows Server 2012 R2 et Windows 10, version 1507 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et Windows 10, version 1507. Lorsqu’une application du Windows Store appelle cette fonction, elle est remplacée par un appel inline à FlsFree. Reportez-vous à FlsFree pour la documentation des fonctions.
Windows 10, version 1511 et Windows 10, version 1607 : cette fonction est entièrement prise en charge pour les applications plateforme Windows universelle (UWP) et n’est plus remplacée par un appel inline à FlsFree.
Si les threads du processus ont alloué de la mémoire et stocké un pointeur vers la mémoire dans un emplacement TLS, ils doivent libérer la mémoire avant d’appeler TlsFree. La fonction TlsFree ne libère pas les blocs de mémoire dont les adresses ont été stockées dans les emplacements TLS associés à l’index TLS. Il est attendu que les DLL appellent cette fonction (le cas échéant) uniquement pendant DLL_PROCESS_DETACH.
Pour plus d’informations, consultez Stockage local des threads.
Exemples
Pour obtenir un exemple, consultez Utilisation du stockage local de thread ou Utilisation du stockage local de threads dans une bibliothèque Dynamic-Link.
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 Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothèque | Kernel32.lib ; WindowsPhoneCore.lib sur Windows Phone 8.1 |
| DLL | KernelBase.dll sur Windows Phone 8.1 ; Kernel32.dll |