Função FlsSetValue (fibersapi.h)

  • Artigo

Armazena um valor no slot fls (armazenamento local de fibra) da fibra de chamada para o índice FLS especificado. Cada fibra tem seu próprio slot para cada índice FLS.

Sintaxe

BOOL FlsSetValue(
  [in]           DWORD dwFlsIndex,
  [in, optional] PVOID lpFlsData
);

Parâmetros

[in] dwFlsIndex

O índice FLS alocado pela função FlsAlloc .

[in, optional] lpFlsData

O valor a ser armazenado no slot FLS para a fibra de chamada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os erros a seguir podem ser retornados.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 O índice não está no intervalo.
ERROR_NO_MEMORY
 A matriz FLS não foi alocada.

Comentários

Normalmente, os índices FLS são alocados pela função FlsAlloc durante a inicialização de processo ou DLL. Depois que um índice FLS é alocado, cada fibra do processo pode usá-lo para acessar seu próprio slot FLS para esse índice. Um thread especifica um índice FLS em uma chamada para FlsSetValue para armazenar um valor em seu slot. O thread especifica o mesmo índice em uma chamada subsequente para FlsGetValue para recuperar o valor armazenado.

Requisitos

Requisito Valor
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

Confira também

Fibras

FlsAlloc

FlsGetValue

Funções de thread e processo