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

Синтаксис

lpCallback

[in] Указатель на определяемую программой функцию повторного вызова типа PFLS_CALLBACK_FUNCTION. Этот параметр необязательный. Для получения дополнительной информации, см. FlsCallback.

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

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

Нити процесса могут использовать индекс FLS в последующих вызовах функций FlsFree, FlsSetValue или FlsGetValue.

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

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

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, FlsCallback, FlsFree, FlsGetValue, FlsSetValue