Funzione FlsAlloc (fiberapi.h)
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 |