Функция FlsSetValue


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

Синтаксис

BOOL FlsSetValue(
  DWORD dwFlsIndex,
  PVOID lpFlsData
);

Параметры

dwFlsIndex

[in] Индекс FLS, который был назначен функцией FlsAlloc.

lpFlsData

[in] Значение, которое будет сохранено в слоте FLS для обращающейся нити

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

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

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

Ошибка

Описание

ERROR_INVALID_PARAMETER

Индекс не в диапазоне. 

ERROR_NO_MEMORY

Массив FLS не был выделен. 

Замечания

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

Смотри также

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

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

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