Функция
TlsAllocФункция
TlsAlloc назначает индекс локальной памяти потока (TLS). Любой поток процесса может впоследствии использовать этот индекс, чтобы сохранить и получить значения, которые являются локальными для потока.Синтаксис
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 |
Нет |
Замечания по платформе |
Не имеется |