SetThreadCoNtext 函式 (processthreadsapi.h)

發行項
08/25/2023

設定指定執行緒的內容。

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