ICorDebugHeapValue2::CreateHandle-Methode

Erstellt ein Handle des angegebenen Typs für den heap-Wert, der durch dieses ICorDebugHeapValue2 -Objekt dargestellt wird.

Syntax

HRESULT CreateHandle (
    [in] CorDebugHandleType      type,
    [out] ICorDebugHandleValue   **ppHandle
);

Die Parameter

type [in] Ein Wert der CorDebugHandleType-Aufzählung, die den Typ des zu erstellenden Handles angibt.

ppHandle [out] Ein Zeiger auf die Adresse eines ICorDebugHandleValue-Objekts, das das neue Handle für diesen Heapwert darstellt.

Bemerkungen

Das Handle wird in der Anwendungsdomäne erstellt, die dem Heap-Wert zugeordnet ist, und wird ungültig, wenn die Anwendungsdomäne entladen wird.

Mehrere Aufrufe dieser Funktion für denselben Heap-Wert erstellen mehrere Handles. Da Handles sich auf die Leistung des Garbage Collector auswirken, sollte sich der Debugger auf eine relativ kleine Anzahl von Handles (ca. 256) beschränken, die jeweils aktiv sind.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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