Функция TlsAlloc назначает индекс локальной памяти потока (TLS). Любой поток процесса может впоследствии использовать этот индекс, чтобы сохранить и получить значения, которые являются локальными для потока.

Если функция завершается успешно, величина возвращаемого значения - индекс локальной памяти потока (TLS). Слоты памяти индекса инициализируются нулями.

Если функция завершается с ошибкой, величина возвращаемого значения - TLS_OUT_OF_INDEXES. Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Потоки процесса могут использовать индекс TLS в последующих вызовах функций TlsFree, TlsSetValue или TlsGetValue.

Индексы локальной памяти потока (TLS) обычно назначаются в ходе инициализации процесса или динамически подключаемой библиотеки (DLL). После назначения индекса TLS, каждый поток процесса может использовать его, чтобы обратиться к своим собственным слотам памяти TLS. Чтобы сохранить значение в своем слоте, поток устанавливает индекс при вызове TlsSetValue. Поток устанавливает тот же самый индекс при последующих вызовах TlsGetValue, чтобы получить сохраненное значение.

Индексы TLS не допустимы за границами процесса. DLL не может предполагать, что индекс, назначенный в одном процессе правилен в другом процессе.

За дополнительной информацией обратитесь к статье Локальная память потока.

Пример смотри Использование локальной памяти потока или Использование локальной памяти потока в динамически подключаемых библиотеках.

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, TlsFree, TlsGetValue, TlsSetValue