ICorDebugThread::EnumerateChains, méthode

Obtient un pointeur d’interface vers un énumérateur ICorDebugChainEnum qui contient toutes les chaînes de pile dans cet objet ICorDebugThread.

Syntaxe

HRESULT EnumerateChains (
    [out] ICorDebugChainEnum **ppChains
);

Paramètres

ppChains [out] Pointeur vers l’adresse d’un ICorDebugChainEnum objet qui permet l’énumération de toutes les chaînes de pile dans ce thread, en commençant à la chaîne active (autrement dit, la plus récente).

Notes

La chaîne de pile représente la pile d’appels physique du thread. Les circonstances suivantes créent une limite de chaîne de pile :

• Transition de managé à non managé et vice versa.

• Commutateur de contexte.

• Détournement d’un débogueur d’un thread utilisateur.

Dans le cas simple d’un thread qui exécute purement du code managé dans un contexte unique, une correspondance un-à-un existe entre les threads et les chaînes de pile.

Un débogueur peut vouloir réorganiser les piles d’appels physiques de tous les threads en piles d’appels logiques. Cela implique de trier toutes les chaînes des threads par leurs relations appelant/appelé et de les regrouper.

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