共用方式為


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

另請參閱

上下文

偵錯函式

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread