ICorProfilerCallback::ExceptionCatcherEnter, méthode

Avertit le profileur que le contrôle est passé au bloc catch approprié.

Syntaxe

HRESULT ExceptionCatcherEnter(  
    [in] FunctionID functionId,  
    [in] ObjectID   objectId);  

Paramètres

functionId
[in] Identificateur de la fonction contenant le bloc catch.

objectId
[in] Identificateur de l’exception gérée.

Notes

La méthode ExceptionCatcherEnter est appelée uniquement si le point d’interception se trouve dans un code compilé avec le compilateur juste-à-temps (JIT). Une exception interceptée dans du code non managé ou dans le code interne du runtime n’appellera pas cette notification. La valeur objectId est passée à nouveau, car un nettoyage de la mémoire pourrait avoir déplacé l’objet depuis la notification ExceptionThrown.

Le profileur ne devrait pas bloquer dans son implémentation de cette méthode, car il se peut que la pile ne soit pas dans un état permettant le nettoyage de la mémoire, de sorte que le nettoyage de la mémoire préemptif ne peut pas être activé. Si le profileur bloque ici et qu’un nettoyage de la mémoire est tenté, le runtime bloque jusqu’à ce que ce rappel retourne.

L’implémentation de cette méthode par le profileur ne devrait pas appeler de code managé ou entraîner d’allocation de mémoire managée.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi

• ICorProfilerCallback, interface
• ExceptionCatcherLeave, méthode