Função FlsAlloc (fibersapi.h)

Artigo
08/23/2023

Aloca um índice FLS (armazenamento local de fibra). Qualquer fibra no processo pode usar posteriormente esse índice para armazenar e recuperar valores que são locais para a fibra.

Sintaxe

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Parâmetros

[in] lpCallback

Um ponteiro para a função de retorno de chamada definida pelo aplicativo do tipo PFLS_CALLBACK_FUNCTION. Esse parâmetro é opcional. Para obter mais informações, consulte FlsCallback.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um índice FLS inicializado como zero.

Se a função falhar, o valor retornado será FLS_OUT_OF_INDEXES. Para obter informações de erro estendidas, chame GetLastError.

Comentários

As fibras do processo podem usar o índice FLS em chamadas subsequentes para as funções FlsFree, FlsSetValue ou FlsGetValue .

Normalmente, os índices FLS são alocados durante o processo ou a inicialização da DLL (biblioteca de vínculo dinâmico). Depois que um índice FLS tiver sido alocado, cada fibra do processo poderá usá-lo para acessar seu próprio slot de armazenamento FLS. Para armazenar um valor em seu slot FLS, uma fibra especifica o índice em uma chamada para FlsSetValue. A fibra especifica o mesmo índice em uma chamada subsequente para FlsGetValue para recuperar o valor armazenado.

Os índices FLS não são válidos entre os limites do processo. Uma DLL não pode assumir que um índice atribuído em um processo é válido em outro processo.

Requisitos


Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	fibersapi.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll