ICorDebugHeapValue2::CreateHandle-Methode

Erstellt ein Handle vom angegebenen Typ für den durch dieses ICorDebugHeapValue2-Objekt dargestellten Heapwert.

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

Parameter

• type
  [in] Ein Wert der CorDebugHandleType-Enumeration, der den Typ des Handles angibt, der erstellt werden soll.

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

Hinweise

Das Handle wird in der dem Heapwert zugeordneten Anwendungsdomäne erstellt, und es wird ungültig, wenn die Anwendungsdomäne entladen wird.

Durch mehrere Aufrufe dieser Funktion für denselben Heapwert werden mehrere Handles erstellt. Da Handles Auswirkungen auf die Leistung des Garbage Collector haben, sollte der Debugger sich selbst auf eine relativ kleine Anzahl gleichzeitig aktiver Handles (ca. 256) beschränken.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICorDebugHeapValue2-Schnittstelle