Funzione TlsFree (processthreadsapi.h)

Articolo
02/07/2024

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