Fungsi TlsFree (processthreadsapi.h)

Artikel
02/07/2024

Merilis indeks penyimpanan lokal utas (TLS), membuatnya tersedia untuk digunakan kembali.

Sintaks

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

Parameter

[in] dwTlsIndex

Indeks TLS yang dialokasikan oleh fungsi TlsAlloc .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Windows Phone 8.1: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8.1 dan yang lebih baru. Saat aplikasi Windows Phone Store memanggil fungsi ini, aplikasi tersebut diganti dengan panggilan sebaris ke FlsFree. Lihat FlsFree untuk dokumentasi fungsi.

Windows 8.1, Windows Server 2012 R2, dan Windows 10, versi 1507: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan Windows 10, versi 1507. Ketika aplikasi Bursa Windows memanggil fungsi ini, aplikasi diganti dengan panggilan sebaris ke FlsFree. Lihat FlsFree untuk dokumentasi fungsi.

Windows 10, versi 1511 dan Windows 10, versi 1607: Fungsi ini didukung penuh untuk aplikasi Platform Windows Universal (UWP), dan tidak lagi diganti dengan panggilan sebaris ke FlsFree.

Jika utas proses telah mengalokasikan memori dan menyimpan pointer ke memori di slot TLS, mereka harus membebaskan memori sebelum memanggil TlsFree. Fungsi TlsFree tidak membebaskan blok memori yang alamatnya telah disimpan di slot TLS yang terkait dengan indeks TLS. Diharapkan DLL memanggil fungsi ini (jika semuanya) hanya selama DLL_PROCESS_DETACH.

Untuk informasi selengkapnya, lihat Penyimpanan Lokal Utas.

Contoh

Misalnya, lihat Menggunakan Penyimpanan Lokal Utas atau Menggunakan Penyimpanan Lokal Utas di pustaka Dynamic-Link.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib; WindowsPhoneCore.lib di Windows Phone 8.1
DLL	KernelBase.dll Windows Phone 8.1; Kernel32.dll