ICorDebugILFrame2::RemapFunction, méthode

Remapise une fonction modifiée en spécifiant le nouveau décalage CIL (Common Intermediate Language)

Syntaxe

HRESULT RemapFunction (
    [in] ULONG32      newILOffset
);

Paramètres

newILOffset [in] Le nouveau décalage CIL du frame de pile auquel le pointeur d’instruction doit être placé. Cette valeur doit être un point de séquence.

Il incombe à l’appelant de garantir la validité de cette valeur. Par exemple, le décalage CIL n’est pas valide s’il se trouve en dehors des limites de la fonction.

Notes

Lorsque la fonction d’une image a été modifiée, le débogueur peut appeler la méthode RemapFunction pour basculer dans la dernière version de la fonction de l’image afin qu’elle puisse être exécutée. L’exécution du code commence au décalage CIL donné.

Remarque

L’appel de RemapFunction, comme l’appel de ICorDebugILFrame::SetIP, invalide immédiatement toutes les interfaces de débogage liées à la génération d’une trace de pile pour le thread. Ces interfaces incluent ICorDebugChain, ICorDebugILFrame, ICorDebugInternalFrame et ICorDebugNativeFrame.

La méthode RemapFunction peut être appelée uniquement dans le contexte de l’image actuelle, et seulement dans l’un des cas suivants :

• Après réception d’un rappel ICorDebugManagedCallback2::FunctionRemapOpportunity qui n’a pas encore été poursuivi.

• Pendant que l’exécution du code est arrêtée en raison d’un événement ICorDebugManagedCallback::EditAndContinueRemap pour cette trame.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0