Fungsi FlsAlloc (fibersapi.h)

Artikel
03/11/2023

Mengalokasikan indeks penyimpanan lokal serat (FLS). Serat apa pun dalam proses selanjutnya dapat menggunakan indeks ini untuk menyimpan dan mengambil nilai yang lokal ke serat.

Sintaks

DWORD FlsAlloc(
  [in] PFLS_CALLBACK_FUNCTION lpCallback
);

Parameter

[in] lpCallback

Penunjuk ke fungsi panggilan balik jenis PFLS_CALLBACK_FUNCTION yang ditentukan aplikasi. Parameter ini bersifat opsional. Untuk informasi selengkapnya, lihat FlsCallback.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah indeks FLS yang diinisialisasi menjadi nol.

Jika fungsi gagal, nilai yang dikembalikan adalah FLS_OUT_OF_INDEXES. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Serat proses dapat menggunakan indeks FLS dalam panggilan berikutnya ke fungsi FlsFree, FlsSetValue, atau FlsGetValue .

Indeks FLS biasanya dialokasikan selama proses atau inisialisasi pustaka tautan dinamis (DLL). Setelah indeks FLS dialokasikan, setiap serat proses dapat menggunakannya untuk mengakses slot penyimpanan FLS-nya sendiri. Untuk menyimpan nilai di slot FLS-nya, serat menentukan indeks dalam panggilan ke FlsSetValue. Serat menentukan indeks yang sama dalam panggilan berikutnya ke FlsGetValue untuk mengambil nilai yang disimpan.

Indeks FLS tidak valid di seluruh batas proses. DLL tidak dapat mengasumsikan bahwa indeks yang ditetapkan dalam satu proses valid dalam proses lain.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	fibersapi.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll