TlsSetValue

指定した TLS インデックスについて、呼び出し側スレッドのスレッドローカルストレージ (TLS) スロットに値を格納する。プロセスの各スレッドは TLS インデックスごとに独自のスロットを持つ。

TlsSetValue dwTlsIndex, lpTlsValue

dwTlsIndex : [int] TlsAlloc 関数で割り当てられた TLS インデックス。
lpTlsValue : [intptr] 呼び出し側スレッドのインデックス用 TLS スロットに格納する値。

(プラグイン / モジュール : kernel32.dll)

解説

指定した TLS インデックスについて、呼び出し側スレッドのスレッドローカルストレージ (TLS)
スロットに値を格納する。プロセスの各スレッドは TLS インデックスごとに独自のスロットを持つ。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
Windows Phone 8.1 / Windows 8.1 / Windows Server 2012 R2 / Windows 10
version 1507: 本関数は対応 Windows Phone / Windows
ストアアプリでサポートされ、FlsSetValue へのインライン呼び出しに置換される。Windows 10 version 1511
以降: 本関数は UWP アプリで完全にサポートされ、もはや置換されない。TLS インデックスは通常 TlsAlloc によりプロセスや
DLL 初期化中に割り当てられる。割り当てられた直後、格納スロットは NULL に初期化される。割り当て後、プロセスの各スレッドはその
TLS スロットへアクセスするためにそのインデックスを使える。TlsSetValue
は速度を最優先に実装され、パラメータ検証は最小限である。dwTlsIndex が 0 から TLS_MINIMUM_AVAILABLE-1
の範囲内であれば成功する。インデックスが有効であることを確認するのはプログラマの責任である。

情報