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

[in] Индекс локальной памяти потока (TLS), который был назначен функцией TlsAlloc.

[in] Значение индекса, заданное при помощи dwTlsIndex, которое будет сохранено в слоте TLS вызывающего потока.

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

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

Функция TlsSetValue была реализована, с первой целью, обеспечить быстродействие. Эти функции выполняют минимальную проверку правильности параметра и проверку ошибок. В частности эта функция завершается успешно, если dwTlsIndex находится в диапазоне от 0 до (TLS_MINIMUM_AVAILABLE - 1). Это зависит от программиста, который должен гарантировать, что индекс допустим.

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

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