Функция TlsFree

Функция TlsFree освобождает индекс локальной памяти потока (TLS), делая его доступным для многократного использования.

Синтаксис

BOOL TlsFree(

DWORD dwTlsIndex // индекс TLS

);

Параметры

dwTlsIndex

[in] Индекс локальной памяти потока (TLS), который был назначен функцией TlsAlloc.

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

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

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

Замечания

Если потоки процесса назначили оперативную память и используют индекс TLS для сохранения указателей на эту память, они должны освободить память перед вызовом TlsFree. Функция TlsFree не освобождает блоки памяти, адреса которых были сохранены в слотах, связанных с индексом TLS. Предполагается, что динамически подключаемые библиотеки (DLL) вызывают эту функцию (если вообще она есть) в ходе своей обработки процедуры отключения DLL_PROCESS_DETACH.

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

Код примера

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

Смотри также

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

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

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