Funzione SetThreadContext (processthreadsapi.h)

Articolo
03/08/2023

Imposta il contesto per il thread specificato.

Un'applicazione a 64 bit può impostare il contesto di un thread WOW64 usando la funzione Wow64SetThreadContext .

Sintassi

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

Parametri

[in] hThread

Handle al thread il cui contesto deve essere impostato. L'handle deve avere il diritto di accesso THREAD_SET_CONTEXT al thread. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.

[in] lpContext

Puntatore a una struttura CONTEXT che contiene il contesto da impostare nel thread specificato. Il valore del membro ContextFlags di questa struttura specifica quali parti del contesto di un thread impostare. Alcuni valori della struttura CONTEXT che non possono essere specificati vengono impostati in modo automatico sul valore corretto. Sono inclusi bit nel registro di stato della CPU che specificano la modalità processore con privilegi, i bit di abilitazione globale nel registro di debug e altri stati che devono essere controllati dal sistema operativo.

Valore restituito

Se il contesto è stato impostato, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione imposta il contesto del thread in base al valore del membro ContextFlags della struttura di contesto. Il thread identificato dal parametro hThread viene in genere eseguito il debug, ma la funzione può funzionare anche quando il thread non viene eseguito il debug.

Non provare a impostare il contesto per un thread in esecuzione; i risultati sono imprevedibili. Usare la funzione SuspendThread per sospendere il thread prima di chiamare SetThreadContext.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll