Funzione FlsAlloc (fiberapi.h)

Articolo
08/23/2023

Alloca un indice di archiviazione locale (FLS) fiber. Qualsiasi fibra nel processo può successivamente usare questo indice per archiviare e recuperare valori locali per la fibra.

Sintassi

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Parametri

[in] lpCallback

Puntatore alla funzione di callback definita dall'applicazione di tipo PFLS_CALLBACK_FUNCTION. Questo parametro è facoltativo e, Per altre informazioni, vedere FlsCallback.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un indice FLS inizializzato su zero.

Se la funzione ha esito negativo, il valore restituito viene FLS_OUT_OF_INDEXES. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le fibre del processo possono usare l'indice FLS nelle chiamate successive alle funzioni FlsFree, FlsSetValue o FlsGetValue .

Gli indici FLS vengono in genere allocati durante l'inizializzazione della libreria a collegamento dinamico o del processo. Dopo aver allocato un indice FLS, ogni fibra del processo può usarla per accedere al proprio slot di archiviazione FLS. Per archiviare un valore nello slot FLS, una fibra specifica l'indice in una chiamata a FlsSetValue. La fibra specifica lo stesso indice in una chiamata successiva a FlsGetValue per recuperare il valore archiviato.

Gli indici FLS non sono validi attraverso i limiti del processo. Una DLL non può presupporre che un indice assegnato in un processo sia valido in un altro processo.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	fiberapi.h
Libreria	Kernel32.lib
DLL	Kernel32.dll