共用方式為


SetThreadContext 函式 (processthreadsapi.h)

設定指定線程的內容。

備註

64 位應用程式可以使用 Wow64SetThreadContext 函式來設定 WOW64 線程的內容。

語法

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

參數

[in] hThread

要設定其內容之線程的句柄。 句柄必須具有線程的 存取權THREAD_SET_CONTEXT 。 如需詳細資訊,請參閱 線程安全性和存取權限

[in] lpContext

CONTEXT 結構的指標,其中包含指定線程中要設定的內容。 這個結構的 ContextFlags 成員值會指定要設定線程內容的哪個部分。 無法指定 之 CONTEXT 結構中的某些值會以無訊息方式設定為正確的值。 這包括 CPU 狀態快取器中的位,指定特殊許可權處理器模式、偵錯快取器中的全域啟用位,以及作系統必須控制的其他狀態。

返回值

如果已設定內容,則傳回值為非零值。

如果函式失敗,傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

函式會根據 內容結構之 ContextFlags 成員的值來設定線程內容。 hThread 參數所識別的線程通常會進行偵錯,但函式也可以運作,即使線程未進行偵錯也一樣。

請勿嘗試設定執行中線程的內容;結果無法預測。 使用 SuspendThread 函式在呼叫 SetThreadContext 之前暫停線程。

需求

要求 價值觀
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
頁首 processthreadsapi.h (包括 Windows.h)
程式庫 內核 32.lib
DLL Kernel32.dll

另請參閱

上下文

偵錯函式

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread