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 |
---|---|
|
索引不在範圍內。 |
|
未配置 FLS 陣列。 |
備註
FLS 索引通常會由 FlsAlloc 函式在進程或 DLL 初始化期間配置。 配置 FLS 索引之後,程式的每個光纖都可以用它來存取該索引的專屬 FLS 位置。 線程會在呼叫 FlsSetValue 時指定 FLS 索引,以在其位置中儲存值。 線程會在後續對 FlsGetValue 的呼叫中指定相同的索引,以擷取預存的值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | fibersapi.h |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |