GetThreadContext 函式 (processthreadsapi.h)
擷取指定線程的內容。
64 位應用程式可以使用 Wow64GetThreadContext 來擷取 WOW64 線程的內容。
語法
BOOL GetThreadContext(
[in] HANDLE hThread,
[in, out] LPCONTEXT lpContext
);
參數
[in] hThread
要擷取其內容的線程句柄。 句柄 必須THREAD_GET_CONTEXT線程 的存取權。 如需詳細資訊,請參閱 線程安全性和訪問許可權。
Windows XP 或 Windows Server 2003: 句柄也必須具有 THREAD_QUERY_INFORMATION 存取權。
[in, out] lpContext
CONTEXT 結構的指標 (,例如接收指定線程適當內容的ARM64_NT_CONTEXT) 。 這個結構的 ContextFlags 成員值會指定擷取線程內容的部分。 CONTEXT 結構是高度處理器特定的。 請參閱 WinNT.h 頭檔,以取得此結構的處理器特定定義,以及任何對齊需求。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
此函式用來擷取指定線程的線程內容。 函式會根據 內容結構之 ContextFlags 成員的值,擷取選擇性內容。 hThread 參數所識別的線程通常會進行偵錯,但當線程未進行偵錯時,函式也可以運作。
您無法取得執行中線程的有效內容。 使用 SuspendThread 函式在呼叫 GetThreadContext 之前暫停線程。
如果您呼叫目前線程的 GetThreadContext ,函式會成功傳回;不過,傳回的內容無效。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | processthreadsapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |