Fungsi TlsSetValue (processthreadsapi.h)

Artikel
02/07/2024

Menyimpan nilai dalam slot penyimpanan lokal utas panggilan (TLS) untuk indeks TLS yang ditentukan. Setiap utas proses memiliki slot sendiri untuk setiap indeks TLS.

Sintaks

BOOL TlsSetValue(
  [in]           DWORD  dwTlsIndex,
  [in, optional] LPVOID lpTlsValue
);

Parameter

[in] dwTlsIndex

Indeks TLS yang dialokasikan oleh fungsi TlsAlloc .

[in, optional] lpTlsValue

Nilai yang akan disimpan di slot TLS utas panggilan untuk indeks.

Mengembalikan nilai

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 FlsSetValue. Lihat FlsSetValue 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 FlsSetValue. Lihat FlsSetValue 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 FlsSetValue.

Indeks TLS biasanya dialokasikan oleh fungsi TlsAlloc selama proses atau inisialisasi DLL. Ketika indeks TLS dialokasikan, slot penyimpanannya diinisialisasi ke NULL. Setelah indeks TLS dialokasikan, setiap utas proses dapat menggunakannya untuk mengakses slot TLS-nya sendiri untuk indeks tersebut. Utas menentukan indeks TLS dalam panggilan ke TlsSetValue, untuk menyimpan nilai di slotnya. Utas menentukan indeks yang sama dalam panggilan berikutnya ke TlsGetValue, untuk mengambil nilai yang disimpan.

TlsSetValue diimplementasikan dengan kecepatan sebagai tujuan utama. Fungsi ini melakukan validasi parameter minimal dan pemeriksaan kesalahan. Secara khusus, itu berhasil jika dwTlsIndex berada dalam rentang 0 sampai (TLS_MINIMUM_AVAILABLE – 1). Terserah programmer untuk memastikan bahwa indeks valid sebelum memanggil TlsGetValue.

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