Funzione SetThreadContext (processthreadsapi.h)
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 |