Функция FlsAlloc (fibersapi.h)

Статья
08/23/2023

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

Синтаксис

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Параметры

[in] lpCallback

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

Возвращаемое значение

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

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

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

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

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	fibersapi.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll