Bagikan melalui

Fungsi GetThreadContext (processthreadsapi.h)

  • Artikel

Mengambil konteks utas yang ditentukan.

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

Sintaks

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 CONTEXT (seperti ARM64_NT_CONTEXT) yang menerima konteks yang sesuai dari utas yang ditentukan. Nilai anggota ContextFlags dari struktur ini menentukan bagian mana dari konteks utas yang diambil. Struktur CONTEXT sangat spesifik prosesor. Lihat file header WinNT.h untuk definisi khusus prosesor dari struktur ini dan persyaratan penyelarasan 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, hubungi GetLastError.

Keterangan

Fungsi ini digunakan untuk mengambil konteks utas dari utas yang ditentukan. Fungsi ini mengambil konteks selektif berdasarkan nilai anggota ContextFlags dari 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

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)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga