Fungsi SetThreadContext (processthreadsapi.h)

Mengatur konteks untuk utas yang ditentukan.

Nota

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

Sintaksis

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

Parameter-parameternya

[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 diatur secara diam-diam 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 diatur, nilai yang dikembalikan bukan nol.

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

Komentar

Fungsi ini mengatur 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

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

Lihat juga

KONTEKS

Fungsi Debugging

getThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread