Freigeben über

ICorDebugHeapValue2::CreateHandle-Methode

  • Artikel

Erstellt ein Handle des angegebenen Typs für den Heapwert, der von diesem ICorDebugHeapValue2-Objekt dargestellt wird.

Syntax

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

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.

Hinweise

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

Durch mehrere Aufrufe dieser Funktion für denselben Heapwert werden mehrere Handles erstellt. Da Handles die Leistung des Garbage Collectors beeinflussen, sollte sich der Debugger auf eine relativ kleine Anzahl von Handles (etwa 256) beschränken, die gleichzeitig aktiv sind.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.