Función FlsAlloc (fibersapi.h)

Artículo
08/23/2023

Asigna un índice de almacenamiento local de fibra (FLS). Cualquier fibra del proceso puede usar posteriormente este índice para almacenar y recuperar valores locales en la fibra.

Sintaxis

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Parámetros

[in] lpCallback

Puntero a la función de devolución de llamada definida por la aplicación de tipo PFLS_CALLBACK_FUNCTION. Este parámetro es opcional. Para obtener más información, consulte FlsCallback.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un índice FLS inicializado en cero.

Si se produce un error en la función, se FLS_OUT_OF_INDEXES el valor devuelto. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Las fibras del proceso pueden usar el índice FLS en llamadas posteriores a las funciones FlsFree, FlsSetValue o FlsGetValue .

Normalmente, los índices FLS se asignan durante la inicialización de la biblioteca de vínculos dinámicos (DLL) o del proceso. Una vez asignado un índice FLS, cada fibra del proceso puede usarla para acceder a su propia ranura de almacenamiento FLS. Para almacenar un valor en su ranura FLS, una fibra especifica el índice en una llamada a FlsSetValue. La fibra especifica el mismo índice en una llamada posterior a FlsGetValue para recuperar el valor almacenado.

Los índices FLS no son válidos a través de los límites del proceso. Un archivo DLL no puede suponer que un índice asignado en un proceso es válido en otro proceso.

Requisitos


Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	fibersapi.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll