FlsSetValue-Funktion (fibersapi.h)

Artikel
02/28/2024

Speichert einen Wert im FLS-Slot (Fiber Local Storage) der aufrufenden Faser für den angegebenen FLS-Index. Jede Faser verfügt über einen eigenen Slot für jeden FLS-Index.

Syntax

BOOL FlsSetValue(
  [in]           DWORD dwFlsIndex,
  [in, optional] PVOID lpFlsData
);

Parameter

[in] dwFlsIndex

Der FLS-Index, der von der FlsAlloc-Funktion zugeordnet wurde.

[in, optional] lpFlsData

Der Wert, der im FLS-Slot für die aufrufende Faser gespeichert werden soll.

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. Die folgenden Fehler können zurückgegeben werden.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Der Index befindet sich nicht im Bereich.
ERROR_NO_MEMORY	Das FLS-Array wurde nicht zugeordnet.

Hinweise

FLS-Indizes werden normalerweise während der Prozess- oder DLL-Initialisierung von der FlsAlloc-Funktion zugeordnet. Nachdem ein FLS-Index zugeordnet wurde, kann jede Faser des Prozesses ihn verwenden, um auf ihren eigenen FLS-Slot für diesen Index zuzugreifen. Ein Thread gibt einen FLS-Index in einem Aufruf von FlsSetValue an, um einen Wert in seinem Slot zu speichern. Der Thread gibt denselben Index in einem nachfolgenden Aufruf von FlsGetValue an, um den gespeicherten Wert abzurufen.

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

FlsGetValue

Prozess- und Threadfunktionen

Freigeben über