Функция TlsAlloc

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

Синтаксис

DWORD TlsAlloc(VOID)

Параметры

У этой функции нет параметров.

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

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

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

Замечания

Потоки процесса могут использовать индекс TLS в последующих вызовах функций TlsFree, TlsSetValue или TlsGetValue.

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

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

За дополнительной информацией обратитесь к статье Локальная память потока.

Код примера

Пример смотри Использование локальной памяти потока или Использование локальной памяти потока в динамически подключаемых библиотеках.

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Kernel32.lib

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

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz