Fungsi SetThreadContext (processthreadsapi.h)

Artikel
08/25/2023

Mengatur konteks untuk utas yang ditentukan.

Aplikasi 64-bit dapat mengatur konteks utas WOW64 menggunakan fungsi Wow64SetThreadContext .

Sintaks

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Parameter

[in] hThread

Handel ke utas yang konteksnya akan diatur. Handel harus memiliki akses THREAD_SET_CONTEXT langsung ke utas. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

[in] lpContext

Penunjuk ke struktur CONTEXT yang berisi konteks yang akan diatur dalam utas yang ditentukan. Nilai anggota ContextFlags dari struktur ini menentukan bagian mana dari konteks utas yang akan ditetapkan. Beberapa nilai dalam struktur CONTEXT yang tidak dapat ditentukan secara diam-diam diatur ke nilai yang benar. Ini termasuk bit dalam register status CPU yang menentukan mode prosesor istimewa, bit pengaktifan global dalam register debugging, dan status lain yang harus dikontrol oleh sistem operasi.

Mengembalikan nilai

Jika konteks ditetapkan, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi ini menetapkan konteks utas berdasarkan nilai anggota ContextFlags dari struktur konteks. Utas yang diidentifikasi oleh parameter hThread biasanya sedang di-debug, tetapi fungsi juga dapat beroperasi bahkan ketika utas tidak di-debug.

Jangan mencoba mengatur konteks untuk utas yang sedang berjalan; hasilnya tidak dapat diprediksi. Gunakan fungsi SuspendThread untuk menangguhkan utas sebelum memanggil SetThreadContext.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll