Функция FlsAlloc (fibersapi.h)
Выделяет индекс волоконного локального хранилища (FLS). Любое волокно в процессе может впоследствии использовать этот индекс для хранения и извлечения значений, которые являются локальными для волокна.
Синтаксис
DWORD FlsAlloc(
[in] PFLS_CALLBACK_FUNCTION lpCallback
);
Параметры
[in] lpCallback
Указатель на определяемую приложением функцию обратного вызова типа PFLS_CALLBACK_FUNCTION. Этот параметр является необязательным. Дополнительные сведения см. в разделе FlsCallback.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение представляет собой индекс FLS, инициализируемый нулевым значением.
Если функция завершается сбоем, возвращаемое значение будет FLS_OUT_OF_INDEXES. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Волокна процесса могут использовать индекс FLS в последующих вызовах функций FlsFree, FlsSetValue или FlsGetValue .
Индексы 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 |