ICorDebugThread::EnumerateChains-Methode

Ruft einen Schnittstellenzeiger auf einen ICorDebugChainEnum-Enumerator ab, der alle Stapelketten in diesem ICorDebugThread -Objekt enthält.

Syntax

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

Die Parameter

ppChains [out] Ein Zeiger auf die Adresse eines ICorDebugChainEnum Objekts, das die Aufzählung aller Stapelketten in diesem Thread zulässt, beginnend mit der aktiven (d. h. der letzten) Kette.

Bemerkungen

Die Stapelkette stellt den physischen Aufrufstapel für den Thread dar. Unter den folgenden Umständen wird eine Stapelkettengrenze erstellt:

• Ein verwalteter oder nicht verwalteter Übergang.

• Ein Kontextschalter.

• Ein Debugger-Entführer eines Benutzerthreads.

Im einfachen Fall für einen Thread, der rein verwalteten Code in einem einzigen Kontext ausführt, besteht eine 1:1-Korrespondenz zwischen Threads und Stapelketten.

Ein Debugger möchte möglicherweise die physischen Aufrufstapel aller Threads in logische Aufrufstapel neu anordnen. Dies würde dazu führen, dass alle Threads-Ketten nach ihren Anrufer-/Angerufenenbeziehungen sortiert und die Gruppierung neu gruppiert wird.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 1.0