Fonction FlsSetValue (fibersapi.h)

Article
02/28/2024

Stocke une valeur dans l’emplacement FLS (Fiber Local Storage) de la fibre appelante pour l’index FLS spécifié. Chaque fibre a son propre emplacement pour chaque index FLS.

Syntaxe

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

Paramètres

[in] dwFlsIndex

Index FLS alloué par la fonction FlsAlloc .

[in, optional] lpFlsData

Valeur à stocker dans l’emplacement FLS pour la fibre appelante.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les erreurs suivantes peuvent être retournées.

Code de retour	Description
ERROR_INVALID_PARAMETER	L’index n’est pas dans la plage.
ERROR_NO_MEMORY	Le tableau FLS n’a pas été alloué.

Remarques

Les index FLS sont généralement alloués par la fonction FlsAlloc pendant l’initialisation du processus ou de la DLL. Une fois qu’un index FLS est alloué, chaque fibre du processus peut l’utiliser pour accéder à son propre emplacement FLS pour cet index. Un thread spécifie un index FLS dans un appel à FlsSetValue pour stocker une valeur dans son emplacement. Le thread spécifie le même index dans un appel suivant à FlsGetValue pour récupérer la valeur stockée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	fibersapi.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fibres

FlsAlloc

FlsGetValue

Fonctions de processus et de thread

Partager via