TlsAlloc 関数 (processthreadsapi.h)

[アーティクル]
03/01/2024

スレッドローカルストレージ (TLS) インデックスを割り当てます。プロセスのすべてのスレッドは、その後、このインデックスを使用して、スレッドに対してローカルな値を格納および取得できます。これは、各スレッドがインデックスの独自のスロットを受け取るためです。

構文

DWORD TlsAlloc();

戻り値

関数が成功した場合、戻り値は TLS インデックスです。インデックスのスロットは 0 に初期化されます。

関数が失敗した場合、戻り値は TLS_OUT_OF_INDEXES。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

Windows Phone 8.1: この関数は、Windows Phone 8.1 以降の Windows Phone ストアアプリでサポートされています。 Windows Phone ストアアプリがこの関数を呼び出すと、FlsAlloc へのインライン呼び出しに置き換えられます。関数のドキュメントについては、 FlsAlloc を参照してください。

Windows 8.1、Windows Server 2012 R2、Windows 10 バージョン 1507: この関数は、Windows 8.1、Windows Server 2012 R2、Windows 10、バージョンの Windows ストアアプリでサポートされています1507. Windows ストアアプリがこの関数を呼び出すと、 FlsAlloc へのインライン呼び出しに置き換えられます。関数のドキュメントについては、 FlsAlloc を参照してください。

Windows 10、バージョン 1511 および Windows 10 バージョン 1607: この関数は、ユニバーサル Windows プラットフォーム (UWP) アプリで完全にサポートされており、FlsAlloc のインライン呼び出しに置き換えなくなりました。

プロセスのスレッドは、 TlsFree、 TlsSetValue、または TlsGetValue 関数の後続の呼び出しで TLS インデックスを使用できます。 TLS インデックスの値は不透明な値として扱う必要があります。は、0 から始まる配列へのインデックスであるとは想定しません。

TLS インデックスは通常、プロセスまたはダイナミックリンクライブラリ (DLL) の初期化中に割り当てられます。 TLS インデックスが割り当てられると、そのストレージスロットは NULL に初期化されます。 TLS インデックスが割り当てられた後、プロセスの各スレッドはそれを使用して、独自の TLS ストレージスロットにアクセスできます。 TLS スロットに値を格納するために、スレッドは TlsSetValue の呼び出しでインデックスを指定します。スレッドは、格納されている値を取得するために、 TlsGetValue の後続の呼び出しで同じインデックスを指定します。

TLS インデックスは、プロセスの境界を越えて有効ではありません。 DLL では、あるプロセスで割り当てられたインデックスが別のプロセスで有効であると想定することはできません。

例

例については、「スレッドローカルストレージの使用」または「 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