Funzione SetThreadContext (processthreadsapi.h)

Imposta il contesto per il thread specificato.

Sintassi

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

Parametri

[in] hThread

Handle per il 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.

[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 le parti del contesto di un thread da impostare. Alcuni valori nella struttura CONTEXT che non possono essere specificati vengono impostati automaticamente sul valore corretto. Sono inclusi i 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

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 sottoposto a debug, ma la funzione può funzionare anche quando il thread non viene sottoposto a debug.

Non tentare di 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

Vedere anche

CONTESTO

funzioni di debug

getThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread