FlsAlloc-Funktion (fibersapi.h)

Artikel
08/23/2023

Weist einen FLS-Index (Fiber Local Storage) zu. Jede Faser im Prozess kann diesen Index anschließend zum Speichern und Abrufen von Werten verwenden, die lokal für die Fasern sind.

Syntax

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Parameter

[in] lpCallback

Ein Zeiger auf die anwendungsdefinierte Rückruffunktion vom Typ PFLS_CALLBACK_FUNCTION. Dieser Parameter ist optional. Weitere Informationen finden Sie unter FlsCallback.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein FLS-Index, der mit null initialisiert wird.

Wenn die Funktion fehlschlägt, wird der Rückgabewert FLS_OUT_OF_INDEXES. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Fasern des Prozesses können den FLS-Index in nachfolgenden Aufrufen der Funktionen FlsFree, FlsSetValue oder FlsGetValue verwenden.

FLS-Indizes werden in der Regel während der Prozess- oder DLL-Initialisierung (Dynamic Link Library) zugeordnet. Nachdem ein FLS-Index zugewiesen wurde, kann jede Faser des Prozesses ihn verwenden, um auf ihren eigenen FLS-Speicherslot zuzugreifen. Um einen Wert in seinem FLS-Slot zu speichern, gibt eine Faser den Index in einem Aufruf von FlsSetValue an. Die Faser gibt denselben Index in einem nachfolgenden Aufruf von FlsGetValue an, um den gespeicherten Wert abzurufen.

FLS-Indizes sind nicht über Prozessgrenzen hinweg gültig. Eine DLL kann nicht davon ausgehen, dass ein in einem Prozess zugewiesener Index in einem anderen Prozess gültig ist.

Anforderungen


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