TlsFree-Funktion (processthreadsapi.h)

Artikel
03/01/2024

Gibt einen TLS-Index (Thread Local Storage) frei, sodass er wiederverwendet werden kann.

Syntax

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

Parameter

[in] dwTlsIndex

Der TLS-Index, der von der TlsAlloc-Funktion zugeordnet wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Windows Phone 8.1: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8.1 unterstützt. Wenn eine Windows Phone Store-App diese Funktion aufruft, wird sie durch einen Inlineaufruf von FlsFree ersetzt. Die Dokumentation zu Funktionen finden Sie unter FlsFree .

Windows 8.1, Windows Server 2012 R2 und Windows 10, Version 1507: Diese Funktion wird für Windows Store-Apps unter Windows 8.1, Windows Server 2012 R2 und Windows 10 unterstützt. 1507. Wenn eine Windows Store-App diese Funktion aufruft, wird sie durch einen Inlineaufruf von FlsFree ersetzt. Die Dokumentation zu Funktionen finden Sie unter FlsFree .

Windows 10, Version 1511 und Windows 10, Version 1607: Diese Funktion wird für Universelle Windows-Plattform-Apps (UWP) vollständig unterstützt und nicht mehr durch einen Inlineaufruf von FlsFree ersetzt.

Wenn die Threads des Prozesses Arbeitsspeicher zugewiesen und einen Zeiger auf den Arbeitsspeicher in einem TLS-Slot gespeichert haben, sollten sie den Arbeitsspeicher vor dem Aufrufen von TlsFree freigeben. Die TlsFree-Funktion gibt keine Speicherblöcke frei, deren Adressen in den TLS-Slots gespeichert wurden, die dem TLS-Index zugeordnet sind. Es wird erwartet, dass DLLs diese Funktion (wenn überhaupt) nur während DLL_PROCESS_DETACH aufrufen.

Weitere Informationen finden Sie unter Thread Local Storage.

Beispiele

Ein Beispiel finden Sie unter Verwenden des lokalen Threadspeichers oder Verwenden des lokalen Threadspeichers in einer Dynamic-Link Bibliothek.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (einschließlich Windows.h unter Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib; WindowsPhoneCore.lib auf Windows Phone 8.1
DLL	KernelBase.dll am Windows Phone 8.1; Kernel32.dll