Methode ICorDebugStackWalk::GetContext

Artikel
05/09/2023

Retourneert de context voor het huidige frame in het object ICorDebugStackWalk .

Syntaxis

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

Parameters

contextFlags
[in] Vlaggen die de aangevraagde inhoud van de contextbuffer aangeven (gedefinieerd in WinNT.h).

contextBufSize
[in] De toegewezen grootte van de contextbuffer.

contextSize
[uit] De werkelijke grootte van de context. Deze waarde moet kleiner zijn dan of gelijk zijn aan de grootte van de contextbuffer.

contextBuf
[uit] De contextbuffer.

Retourwaarde

Deze methode retourneert de volgende specifieke HRESULT's en HRESULT-fouten die wijzen op een fout in de methode.

HRESULT	Beschrijving
S_OK	De context voor het huidige frame is geretourneerd.
E_FAIL	De context kan niet worden geretourneerd.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER)	De contextbuffer is te klein.
CORDBG_E_PAST_END_OF_STACK	De framepointer bevindt zich al aan het einde van de stapel; daarom kunnen er geen extra frames worden geopend.

Uitzonderingen

Opmerkingen

Omdat bij het afwikkelen slechts een subset van de registers wordt hersteld, zoals niet-vluchtige registers, komt de context mogelijk niet exact overeen met de status van het register op het moment van de aanroep.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 4

Delen via