flsAlloc 函数 (fibersapi.h)

(FLS) 索引分配光纤本地存储。进程中的任何光纤随后都可以使用此索引来存储和检索光纤本地的值。

语法

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

[in] lpCallback

指向 PFLS_CALLBACK_FUNCTION 类型的应用程序定义的回调函数的指针。此参数是可选的。有关详细信息，请参阅 FlsCallback。

如果函数成功，则返回值为初始化为零的 FLS 索引。

如果函数失败，则返回值FLS_OUT_OF_INDEXES。要获得更多的错误信息，请调用 GetLastError。

进程的光纤可以在后续调用 FlsFree、FlsSetValue 或 FlsGetValue 函数时使用 FLS 索引。

FLS 索引通常在进程或动态链接库 (DLL) 初始化期间分配。分配 FLS 索引后，进程的每个光纤都可以使用它来访问自己的 FLS 存储槽。若要在其 FLS 槽中存储值，光纤在调用 FlsSetValue 时指定索引。纤程在后续调用 FlsGetValue 中指定相同的索引，以检索存储的值。

FLS 索引跨进程边界无效。 DLL 不能假定在一个进程中分配的索引在另一个进程中有效。