Share via


FlsGetValue 函式 (fibersapi.h)

針對指定的 FLS 索引,擷取呼叫光纖的光纖本機記憶體 (FLS) 位置中的值。 每個光纖針對每個 FLS 索引都有自己的位置。

語法

PVOID FlsGetValue(
  [in] DWORD dwFlsIndex
);

參數

[in] dwFlsIndex

FlsAlloc 函式所配置的 FLS 索引。

傳回值

如果函式成功,傳回值就是儲存在呼叫光纖的 FLS 位置中與指定索引相關聯的值。

如果函式失敗,則傳回值為 NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

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

規格需求

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

另請參閱

纖維

FlsAlloc

FlsSetValue

處理序和執行緒函式