Partager via


ICorDebugILFrame::SetIP, méthode

Définit le pointeur d’instruction à l’emplacement de décalage spécifié dans le code CIL (Common Intermediate Language).

Syntaxe

HRESULT SetIP (
    [in] ULONG32 nOffset
);

Paramètres

nOffset Emplacement de décalage dans le code CIL.

Notes

Appels à SetIP pour invalider immédiatement l’ensemble des frames et des chaînes pour le thread actuel. Si le débogueur a besoin d’informations de frame après un appel à SetIP, il doit effectuer une nouvelle trace.

ICorDebug tentera de conserver le frame de pile dans un état valide. Toutefois, même si le frame est dans un état valide, il peut toujours y avoir des problèmes tels que des variables locales non initialisées. Il incombe à l’appelant de veiller à la cohérence du programme en cours d’exécution.

Sur des plateformes 64 bits, le pointeur d’instruction ne peut pas être déplacé hors d’un bloc catch ou finally. Si SetIP est appelé pour effectuer un tel déplacement sur une plateforme 64 bits, il retourne un HRESULT indiquant un échec.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible à partir de la version 1.0