FlsAlloc, fonction (fibresapi.h)
Alloue un index FLS (Fibre Local Storage). Toute fibre du processus peut ensuite utiliser cet index pour stocker et récupérer des valeurs locales dans 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.
Remarques
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 lors de l’initialisation de la 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 attribué dans un processus est valide dans un autre processus.
Configuration requise
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 | fibresapi.h |
Bibliothèque | Kernel32.lib |
DLL | Kernel32.dll |