FlsAlloc 函式 (fibersapi.h)

發行項
03/11/2023

配置光纖本機儲存體 (FLS) 索引。進程中的任何光纖後續都可以使用此索引來儲存和擷取光纖本機的值。

語法

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

參數

[in] lpCallback

類型 為 PFLS_CALLBACK_FUNCTION的應用程式定義回呼函式指標。這是選擇性參數。如需詳細資訊，請參閱 FlsCallback。

傳回值

如果函式成功，傳回值為已初始化為零的 FLS 索引。

如果函式失敗，傳回值會FLS_OUT_OF_INDEXES。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

程式的光纖可以在後續呼叫FlsFree、FlsSetValue或FlsGetValue函式時使用 FLS 索引。

FLS 索引通常會在進程或動態連結程式庫期間配置， (DLL) 初始化。配置 FLS 索引之後，程式的每個光纖都可以使用它來存取自己的 FLS 儲存位置。若要將值儲存在其 FLS 位置中，Fiber 會在對 FlsSetValue的呼叫中指定索引。 Fiber 會在後續呼叫 FlsGetValue 時指定相同的索引，以擷取預存值。

FLS 索引在進程界限之間無效。 DLL 無法假設某個進程中指派的索引在另一個進程中有效。

需求


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