Share via

FlsSetValue 函式 (fibersapi.h)

  • 發行項

針對指定的 FLS 索引，將值儲存在呼叫光纖的光纖本機記憶體 (FLS) 位置。 每個光纖針對每個 FLS 索引都有自己的位置。

語法

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

參數

[in] dwFlsIndex

FlsAlloc 函式所配置的 FLS 索引。

[in, optional] lpFlsData

要儲存在呼叫光纖之 FLS 位置中的值。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 可以傳回下列錯誤。

傳回碼 Description
ERROR_INVALID_PARAMETER
 索引不在範圍內。
ERROR_NO_MEMORY
 未配置 FLS 陣列。

備註

FLS 索引通常會由 FlsAlloc 函式在進程或 DLL 初始化期間配置。 配置 FLS 索引之後，程式的每個光纖都可以用它來存取該索引的專屬 FLS 位置。 線程會在呼叫 FlsSetValue 時指定 FLS 索引，以在其位置中儲存值。 線程會在後續對 FlsGetValue 的呼叫中指定相同的索引，以擷取預存的值。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 fibersapi.h
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

纖維

FlsAlloc

FlsGetValue

處理序和執行緒函式