Metodo ICorDebugVirtualUnwinder::GetContextICorDebugVirtualUnwinder::GetContext Method

Ottiene il contesto corrente di questo agente di rimozione.Gets the current context of this unwinder.

SintassiSyntax

HRESULT GetContext(  
   [in] ULONG32 contextFlags,  
   [in] ULONG32 cbContextBuf,  
   [out] ULONG32* contextSize,  
   [out, size_is(cbContextBuf)] BYTE contextBuf[]  
);  

ParametriParameters

contextFlags
[in] Flag che specificano le parti del contesto da restituire (definite in WinNT.h).[in] Flags that specify which parts of the context to return (defined in WinNT.h).

cbContextBuf
[in] Numero di byte in contextBuf.[in] The number of bytes in contextBuf.

contextSize
[out] Puntatore al numero di byte effettivamente scritti in contextBuf.[out] A pointer to the number of bytes actually written to contextBuf.

contextBuf
[out] Matrice di byte che contiene il contesto corrente di questo agente di rimozione.[out] A byte array that contains the current context of this unwinder.

Valore restituitoReturn Value

Qualsiasi valore HRESULT con errori ricevuto da mscordbi viene considerato irreversibile e causa la restituzione di CORDBG_E_DATA_TARGET_ERROR da parte delle API ICorDebug.Any failing HRESULT value received by mscordbi is considered fatal and will cause ICorDebug APIs to return CORDBG_E_DATA_TARGET_ERROR.

NoteRemarks

Impostare il valore iniziale del contextBuf argomento per il buffer del contesto restituito dalla chiamata di ICorDebugStackWalk:: (metodo).You set the initial value of the contextBuf argument to the context buffer returned by calling the ICorDebugStackWalk::GetContext method.

Nota

Questo metodo è disponibile solo con .NET Native.This method is available with .NET Native only.

Poiché l'agente di rimozione potrebbe ripristinare solo un subset dei registri, ad esempio solo quelli non volatili, il contesto potrebbe non corrispondere esattamente allo stato del registro al momento dell'effettiva chiamata al metodo.Because unwinding may only restore a subset of the registers, such as the non-volatile registers only, the context may not exactly match the register state at the time of the actual method call.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cordebug. idl, Cordebug. HHeader: CorDebug.idl, CorDebug.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile a partire dalla versione 4.6, solo in .NET NativeAvailable since 4.6, .NET Native only.NET Framework Versions: Disponibile a partire dalla versione 4.6, solo in .NET NativeAvailable since 4.6, .NET Native only

Vedere ancheSee Also

Interfaccia ICorDebugMemoryBufferICorDebugMemoryBuffer Interface
Interfacce di debugDebugging Interfaces