Fungsi GetThreadContext (processthreadsapi.h)

Mengambil konteks utas yang ditentukan.

Nota

Aplikasi 64-bit dapat mengambil konteks utas WOW64 menggunakan fungsi Wow64GetThreadContext.

Sintaksis

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

Parameter

[in] hThread

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

Windows XP atau Windows Server 2003: Handel juga harus memiliki akses THREAD_QUERY_INFORMATION.

[in, out] lpContext

Penunjuk ke struktur KONTEKS (seperti ARM64_NT_CONTEXT) yang menerima konteks yang sesuai dari utas yang ditentukan. Nilai ContextFlags anggota struktur ini menentukan bagian mana dari konteks utas yang diambil. Struktur KONTEKS sangat spesifik untuk prosesor. Lihat file header WinNT.h untuk definisi khusus prosesor dari struktur ini dan persyaratan perataan apa pun.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

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

Anda tidak bisa mendapatkan konteks yang valid untuk utas yang sedang berjalan. Gunakan fungsi SuspendThread untuk menangguhkan utas sebelum memanggil GetThreadContext.

Jika Anda memanggil GetThreadContext untuk utas saat ini, fungsi berhasil dikembalikan; namun, konteks yang dikembalikan tidak valid.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target Windows
Header processthreadsapi.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

  • Last updated on