Fungsi TlsFree (processthreadsapi.h)
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 |