Função TlsFree (processthreadsapi.h)
Libera um índice TLS (armazenamento local de thread), disponibilizando-o para reutilização.
Sintaxe
BOOL TlsFree(
[in] DWORD dwTlsIndex
);
Parâmetros
[in] dwTlsIndex
O índice TLS que foi alocado pela função TlsAlloc .
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Windows Phone 8.1: essa função tem suporte para aplicativos Windows Phone Store no Windows Phone 8.1 e posterior. Quando um aplicativo da Windows Phone Store chama essa função, ele é substituído por uma chamada embutida para FlsFree. Consulte FlsFree para obter a documentação da função.
Windows 8.1, Windows Server 2012 R2 e Windows 10, versão 1507: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e Windows 10, versão 1507. Quando um aplicativo da Windows Store chama essa função, ela é substituída por uma chamada embutida para FlsFree. Consulte FlsFree para obter a documentação da função.
Windows 10, versão 1511 e Windows 10, versão 1607: essa função tem suporte total para aplicativos Plataforma Universal do Windows (UWP) e não é mais substituída por uma chamada embutida para FlsFree.
Se os threads do processo tiverem alocado memória e armazenado um ponteiro para a memória em um slot TLS, eles deverão liberar a memória antes de chamar TlsFree. A função TlsFree não libera blocos de memória cujos endereços foram armazenados nos slots TLS associados ao índice TLS. Espera-se que as DLLs chamem essa função (se em tudo) somente durante DLL_PROCESS_DETACH.
Para obter mais informações, consulte Armazenamento local de thread.
Exemplos
Para obter um exemplo, consulte Usando o armazenamento local do thread ou Usando o armazenamento local de thread em uma biblioteca de Dynamic-Link.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | processthreadsapi.h (inclua Windows.h no Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib; WindowsPhoneCore.lib no Windows Phone 8.1 |
| DLL | KernelBase.dll no Windows Phone 8.1; Kernel32.dll |