Функция TlsFree (processthreadsapi.h)

Статья
02/07/2024

Освобождает индекс локального хранилища потока (TLS), делая его доступным для повторного использования.

Синтаксис

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

Параметры

[in] dwTlsIndex

Индекс TLS, выделенный функцией TlsAlloc .

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

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

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

Windows Phone 8.1. Эта функция поддерживается для приложений магазина Windows Phone в Windows Phone 8.1 и более поздних версий. Когда приложение Windows Phone Store вызывает эту функцию, она заменяется встроенным вызовом FlsFree. Документацию по функциям см. в разделе FlsFree .

Windows 8.1, Windows Server 2012 R2 и Windows 10 версии 1507: эта функция поддерживается для приложений Магазина Windows в Windows 8.1, Windows Server 2012 R2 и Windows 10 версии 1507. Когда приложение Магазина Windows вызывает эту функцию, она заменяется встроенным вызовом FlsFree. Документацию по функциям см. в разделе FlsFree .

Windows 10 версии 1511 и Windows 10 версии 1607: эта функция полностью поддерживается для приложений универсальная платформа Windows (UWP) и больше не заменяется встроенным вызовом FlsFree.

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

Дополнительные сведения см. в разделе Thread Local Storage.

Примеры

Пример см. в разделе Использование локального хранилища потока или Использование локального хранилища потока в библиотеке Dynamic-Link.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	processthreadsapi.h (включая Windows.h в Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib; WindowsPhoneCore.lib на Windows Phone 8.1
DLL	KernelBase.dll Windows Phone 8.1; Kernel32.dll