TlsFree 函式 (processthreadsapi.h)

發行項
03/01/2024

釋放線程本機記憶體 (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