FlsSetValue-Funktion (fibersapi.h)
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 |
|---|---|
|
Der Index befindet sich nicht im Bereich. |
|
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 |