Condividi tramite

Funzione GetThreadContext (processthreadsapi.h)

  • Articolo

Recupera il contesto del thread specificato.

Un'applicazione a 64 bit può recuperare il contesto di un thread WOW64 usando il Wow64GetThreadContext.

Sintassi

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

Parametri

[in] hThread

Handle per il thread il cui contesto deve essere recuperato. L'handle deve avere THREAD_GET_CONTEXT accesso al thread. Per altre informazioni, vedere Thread Security and Access Rights.

Windows XP o Windows Server 2003: Anche l'handle deve avere accesso THREAD_QUERY_INFORMATION.

[in, out] lpContext

Puntatore a una struttura di CONTEXT (ad esempio ARM64_NT_CONTEXT) che riceve il contesto appropriato del thread specificato. Il valore del ContextFlags membro di questa struttura specifica quali parti del contesto di un thread vengono recuperate. La struttura CONTEXT è altamente specifica del processore. Fare riferimento al file di intestazione WinNT.h per le definizioni specifiche del processore di queste strutture ed eventuali requisiti di allineamento.

Valore restituito

Se la funzione ha esito positivo, 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

Questa funzione viene usata per recuperare il contesto del thread specificato. La funzione recupera un contesto selettivo in base al valore del ContextFlags membro 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 è possibile ottenere un contesto valido per un thread in esecuzione. Usare la funzione SuspendThread per sospendere il thread prima di chiamare GetThreadContext.

Se si chiama GetThreadContext per il thread corrente, la funzione restituisce correttamente; tuttavia, il contesto restituito non è valido.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [app desktop | App UWP]
server minimo supportato Windows Server 2003 [app desktop | App UWP]
piattaforma di destinazione Finestre
intestazione processthreadsapi.h (include Windows.h)
libreria Kernel32.lib
dll Kernel32.dll

Vedere anche