Condividi tramite


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

Vedere anche

Fibre

FlsCallback

FlsFree

FlsGetValue

FlsSetValue

Funzioni di processi e thread