ICorDebugHeapValue2::CreateHandle – metoda

Vytvoří popisovač zadaného typu pro hodnotu haldy reprezentované tímto ICorDebugHeapValue2 objektu.

Syntaxe

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

Parametry

type [v] Hodnota CorDebugHandleType výčtu, která určuje typ popisovače, který se má vytvořit.

ppHandle [ven] Ukazatel na adresu ICorDebugHandleValue objektu, který představuje nový popisovač pro tuto hodnotu haldy.

Poznámky

Popisovač se vytvoří v doméně aplikace, která je přidružená k hodnotě haldy, a stane se neplatným, pokud se doména aplikace uvolní.

Více volání této funkce pro stejnou hodnotu haldy vytvoří více popisovačů. Vzhledem k tomu, že popisovače ovlivňují výkon uvolňování paměti, měl by se ladicí program omezit na relativně malý počet popisovačů (přibližně 256), které jsou aktivní najednou.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Záhlaví: CorDebug.idl, CorDebug.h

Knihovna: CorGuids.lib

Verze .NET: K dispozici od rozhraní .NET Framework 2.0