tlsFree 函数 (processthreadsapi.h)
释放线程本地存储 (TLS) 索引,使其可供重复使用。
语法
BOOL TlsFree(
[in] DWORD dwTlsIndex
);
参数
[in] dwTlsIndex
TlsAlloc 函数分配的 TLS 索引。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
Windows Phone 8.1:Windows Phone 8.1 及更高版本上的 Windows Phone 应用商店应用支持此函数。 当Windows Phone应用商店应用调用此函数时,它将替换为对 FlsFree 的内联调用。 有关函数文档 ,请参阅 FlsFree 。
Windows 8.1、Windows Server 2012 R2 和 Windows 10 版本 1507:Windows 8.1、Windows Server 2012 R2 和 Windows 10 版本上的 Windows 应用商店应用支持此函数1507. 当 Windows 应用商店应用调用此函数时,它将替换为 对 FlsFree 的内联调用。 有关函数文档 ,请参阅 FlsFree 。
Windows 10版本 1511 和 Windows 10 版本 1607:通用 Windows 平台 (UWP) 应用完全支持此函数,不再替换为对 FlsFree 的内联调用。
如果进程的线程已分配内存并将指向内存的指针存储在 TLS 槽中,则应在调用 TlsFree 之前释放内存。 TlsFree 函数不会释放其地址已存储在与 TLS 索引关联的 TLS 槽中的内存块。 如果仅在 DLL_PROCESS_DETACH期间) ,则 DLL 应 (调用此函数。
有关详细信息,请参阅 线程本地存储。
示例
有关示例,请参阅 使用线程本地存储 或在 Dynamic-Link 库中使用线程本地存储。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | processthreadsapi.h (包括 Windows Vista 上的 Windows.h、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
Library | Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib |
DLL | Windows Phone 8.1 上的 KernelBase.dll;Kernel32.dll |