共用方式為


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

另請參閱