Methode ICorDebugILFrame2::RemapFunction

Hiermee wordt een bewerkte functie opnieuw toewijzen door de nieuwe offset voor gemeenschappelijke tussenliggende taal (CIL) op te geven

Syntaxis

HRESULT RemapFunction (
    [in] ULONG32      newILOffset
);

Parameters

newILOffset [in] De nieuwe CIL-offset van het stackframe waarop de instructiepointer moet worden geplaatst. Deze waarde moet een reekspunt zijn.

Het is de verantwoordelijkheid van de beller om de geldigheid van deze waarde te waarborgen. De CIL-verschuiving is bijvoorbeeld ongeldig als deze buiten de grenzen van de functie valt.

Opmerkingen

Wanneer de functie van een frame is bewerkt, kan het foutopsporingsprogramma de RemapFunction methode aanroepen om te wisselen in de nieuwste versie van de functie van het frame, zodat deze kan worden uitgevoerd. De uitvoering van de code begint bij de opgegeven CIL-offset.

Notitie

Aanroepen, zoals het aanroepen RemapFunctionvan ICorDebugILFrame::SetIP, zullen onmiddellijk alle foutopsporingsinterfaces die betrekking hebben op het genereren van een stack-trace voor de thread, ongeldig maken. Deze interfaces omvatten ICorDebugChain, ICorDebugILFrame, ICorDebugInternalFrame en ICorDebugNativeFrame.

De RemapFunction methode kan alleen worden aangeroepen in de context van het huidige frame en slechts in een van de volgende gevallen:

• Na ontvangst van een ICorDebugManagedCallback2::FunctionRemapOpportunity callback die nog niet is voortgezet.

• Terwijl de uitvoering van code is gestopt vanwege een ICorDebugManagedCallback::EditAndContinueRemap-gebeurtenis voor dit frame.

Vereisten

Platformen: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework-versies: beschikbaar sinds 2.0