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

进程和线程函数