TlsFree 函式 (processthreadsapi.h)
釋放線程本機記憶體 (TLS) 索引,使其可供重複使用。
語法
BOOL TlsFree(
[in] DWORD dwTlsIndex
);
參數
[in] dwTlsIndex
由 TlsAlloc 函式配置的 TLS 索引。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
Windows Phone 8.1:Windows Phone 8.1 和更新版本上的 Windows Phone Store 應用程式支援此函式。 當 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 只在 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) |
程式庫 | Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib |
Dll | Windows Phone 8.1 上的 KernelBase.dll;Kernel32.dll |