TlsFree 関数 (processthreadsapi.h)

[アーティクル]
02/07/2024

スレッドローカルストレージ (TLS) インデックスを解放し、再利用できるようにします。

構文

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

パラメーター

[in] dwTlsIndex

TlsAlloc 関数によって割り当てられた TLS インデックス。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、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 は、DLL_PROCESS_DETACH中にのみこの関数を呼び出す必要 があります (すべてである場合)。

詳細については、「スレッドローカルストレージ」を参照してください。

例

例については、「スレッドローカルストレージの使用」または「 Dynamic-Link ライブラリでのスレッドローカルストレージの使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	processthreadsapi.h (Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 の場合は Windows.h を含む)
Library	Kernel32.lib;Windows Phone 8.1 の WindowsPhoneCore.lib
[DLL]	Windows Phone 8.1 の KernelBase.dll;Kernel32.dll