Funzione TlsFree (processthreadsapi.h)
Rilascia un indice di archiviazione locale (TLS) thread, rendendolo disponibile per il riutilizzo.
Sintassi
BOOL TlsFree(
[in] DWORD dwTlsIndex
);
Parametri
[in] dwTlsIndex
Indice TLS allocato dalla funzione TlsAlloc .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Windows Phone 8.1: questa funzione è supportata per Windows Phone app dello Store in Windows Phone 8.1 e versioni successive. Quando un'app di Windows Phone Store chiama questa funzione, viene sostituita con una chiamata inline a FlsFree. Per la documentazione della funzione, vedere FlsFree .
Windows 8.1, Windows Server 2012 R2 e Windows 10 versione 1507: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e Windows 10, versione 1507. Quando un'app di Windows Store chiama questa funzione, viene sostituita con una chiamata inline a FlsFree. Per la documentazione della funzione, vedere FlsFree .
Windows 10, versione 1511 e Windows 10, versione 1607: questa funzione è completamente supportata per le app piattaforma UWP (Universal Windows Platform) (UWP) e non viene più sostituita con una chiamata inline a FlsFree.
Se i thread del processo hanno allocato memoria e archiviato un puntatore alla memoria in uno slot TLS, è necessario liberare la memoria prima di chiamare TlsFree. La funzione TlsFree non libera blocchi di memoria i cui indirizzi sono stati archiviati negli slot TLS associati all'indice TLS. È previsto che le DLL chiamino questa funzione (se tutto) solo durante DLL_PROCESS_DETACH.
Per altre informazioni, vedere Archiviazione locale thread.
Esempio
Per un esempio, vedere Uso dell'archiviazione locale dei thread o uso dell'archiviazione locale dei thread in una libreria di Dynamic-Link.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | processthreadsapi.h (include Windows.h in Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib; WindowsPhoneCore.lib in Windows Phone 8.1 |
| DLL | KernelBase.dll Windows Phone 8,1; Kernel32.dll |