Функция FlsAlloc


[ Это - предварительная документация и подвергается изменениям.]

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

Синтаксис

DWORD FlsAlloc(

  PFLS_CALLBACK_FUNCTION lpCallback

);

Параметры

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

Размещение и совместимость FlsAlloc

Windows. NET Server

Да

Windows XP

Нет

Windows 2000

Нет

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz