Função TlsFree (processthreadsapi.h)

Artigo
03/01/2024

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