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 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | processthreadsapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |