設定指定線程的內容。
備註
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 |