Teilen über

ICorDebugProcess::SetThreadContext-Methode

  • Artikel

Legt den Kontext für den angegebenen Thread in diesem Prozess fest.

Syntax

HRESULT SetThreadContext(  
    [in] DWORD threadID,  
    [in] ULONG32 contextSize,  
    [in, length_is(contextSize), size_is(contextSize)]  
    BYTE context[]);

Parameter

threadID
[in] Die ID des Threads, für den der Kontext festgelegt werden soll.

contextSize
[in] Die Größe des context-Arrays.

context
[in] Ein Array von Bytes, die den Kontext des Threads beschreiben.

Der Kontext gibt die Architektur des Prozessors an, auf dem der Thread ausgeführt wird.

Bemerkungen

Der Debugger sollte diese Methode anstelle der Win32-Funktion SetThreadContext aufrufen, da sich der Thread möglicherweise in einem „hijacked“-Zustand befindet, in dem sein Kontext vorübergehend geändert wurde. Diese Methode sollte nur verwendet werden, wenn sich ein Thread im nativen Code befindet. Verwenden Sie ICorDebugRegisterSet für Threads in verwaltetem Code. Sie sollten den Kontext eines Threads während eines Out-of-Band(OOB)-Debugereignisses nie ändern müssen.

Bei den übergegebenen Daten muss es sich um eine Kontextstruktur für die aktuelle Plattform handeln.

Diese Methode kann die Runtime beschädigen, wenn sie nicht ordnungsgemäß verwendet wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.