共用方式為

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 應用程式]
目標平臺 窗戶
標頭 processthreadsapi.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱