TlsFree-Funktion (processthreadsapi.h)
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 |