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 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.For more information, see Thread Security and Access Rights.

Windows XP o Windows Server 2003: L'handle deve avere anche accesso THREAD_QUERY_INFORMATION .

[in, out] lpContext

Puntatore a una struttura CONTEXT (ad esempio ARM64_NT_CONTEXT) che riceve il contesto appropriato del thread specificato. Il valore del membro ContextFlags 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione viene usata per recuperare il contesto del thread specificato. La funzione recupera un contesto selettivo 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ò anche funzionare 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.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione processthreadsapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche