flsSetValue 函数 (fibersapi.h)

将值存储在调用光纤的光纤本地存储 (指定 FLS 索引的 FLS) 槽中。 对于每个 FLS 索引,每个光纤都有自己的槽。

语法

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

参数

[in] dwFlsIndex

FlsAlloc 函数分配的 FLS 索引。

[in, optional] lpFlsData

要存储在调用光纤的 FLS 槽中的值。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 可能会返回以下错误。

返回代码 说明
ERROR_INVALID_PARAMETER
索引不在范围内。
ERROR_NO_MEMORY
尚未分配 FLS 数组。

注解

FLS 索引通常在进程或 DLL 初始化期间由 FlsAlloc 函数分配。 分配 FLS 索引后,进程的每个光纤都可以使用它来访问该索引的自己的 FLS 槽。 线程在调用 FlsSetValue 时指定 FLS 索引,以在其槽中存储值。 线程在对 FlsGetValue 的后续调用中指定相同的索引,以检索存储的值。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 fibersapi.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

纤维

FlsAlloc

FlsGetValue

进程和线程函数