FlsFree-Funktion (fibersapi.h)

  • Artikel

Gibt einen FlS-Index (Fiber Local Storage) frei und stellt ihn zur Wiederverwendung zur Verfügung.

Syntax

BOOL FlsFree(
  [in] DWORD dwFlsIndex
);

Parameter

[in] dwFlsIndex

Der FLS-Index, der von der FlsAlloc-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

Durch das Freigeben eines FLS-Indexes wird der Index für alle Instanzen von FLS im aktuellen Prozess freigegeben. Das Freigeben eines FLS-Indexes führt auch dazu, dass die zugehörige Rückrufroutine für jede Faser aufgerufen wird, wenn der entsprechende FLS-Slot einen Nicht-NULL-Wert enthält.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile fibersapi.h
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Fasern

FlsAlloc

Prozess- und Threadfunktionen