Función TlsFree (processthreadsapi.h)

Artículo
02/07/2024

Libera un índice de almacenamiento local de subprocesos (TLS), lo que hace que esté disponible para su reutilización.

Sintaxis

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

Parámetros

[in] dwTlsIndex

Índice TLS asignado por la función TlsAlloc .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Windows Phone 8.1: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8.1 y versiones posteriores. Cuando una aplicación de Windows Phone Store llama a esta función, se reemplaza por una llamada insertada a FlsFree. Consulte flsFree para obtener la documentación de la función.

Windows 8.1, Windows Server 2012 R2 y Windows 10, versión 1507: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y Windows 10, versión 1507. Cuando una aplicación de la Tienda Windows llama a esta función, se reemplaza por una llamada insertada a FlsFree. Consulte flsFree para obtener la documentación de la función.

Windows 10, versión 1511 y Windows 10, versión 1607: Esta función es totalmente compatible con las aplicaciones de Plataforma universal de Windows (UWP) y ya no se reemplaza por una llamada insertada a FlsFree.

Si los subprocesos del proceso han asignado memoria y han almacenado un puntero a la memoria en una ranura TLS, deben liberar la memoria antes de llamar a TlsFree. La función TlsFree no libera bloques de memoria cuyas direcciones se han almacenado en las ranuras TLS asociadas al índice TLS. Se espera que los archivos DLL llamen a esta función (si es en absoluto) solo durante DLL_PROCESS_DETACH.

Para obtener más información, consulte Almacenamiento local de subprocesos.

Ejemplos

Para obtener un ejemplo, consulte Uso del almacenamiento local de subprocesos o Uso del almacenamiento local de subprocesos en una biblioteca de Dynamic-Link.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluye Windows.h en Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib; WindowsPhoneCore.lib en Windows Phone 8.1
Archivo DLL	KernelBase.dll en Windows Phone 8.1; Kernel32.dll