Fonction FlsAlloc (fibersapi.h)

Article
08/23/2023

Alloue un index de stockage local fibre (FLS). Toute fibre du processus peut ensuite utiliser cet index pour stocker et récupérer des valeurs locales de la fibre.

Syntaxe

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Paramètres

[in] lpCallback

Pointeur vers la fonction de rappel définie par l’application de type PFLS_CALLBACK_FUNCTION. Ce paramètre est facultatif. Pour plus d’informations, consultez FlsCallback.

Valeur retournée

Si la fonction réussit, la valeur de retour est un index FLS initialisé à zéro.

Si la fonction échoue, la valeur de retour est FLS_OUT_OF_INDEXES. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Les fibres du processus peuvent utiliser l’index FLS dans les appels suivants aux fonctions FlsFree, FlsSetValue ou FlsGetValue .

Les index FLS sont généralement alloués pendant l’initialisation de processus ou de bibliothèque de liens dynamiques (DLL). Une fois qu’un index FLS a été alloué, chaque fibre du processus peut l’utiliser pour accéder à son propre emplacement de stockage FLS. Pour stocker une valeur dans son emplacement FLS, une fibre spécifie l’index dans un appel à FlsSetValue. La fibre spécifie le même index dans un appel ultérieur à FlsGetValue pour récupérer la valeur stockée.

Les index FLS ne sont pas valides au-delà des limites de processus. Une DLL ne peut pas supposer qu’un index affecté dans un processus est valide dans un autre processus.

Spécifications


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