Função FlsAlloc (fibersapi.h)
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 |