共用方式為

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

另請參閱