Método ICorDebugHeapValue2::CreateHandle

Cria um identificador do tipo especificado para o valor de heap representado por este objeto ICorDebugHeapValue2.

Sintaxe

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

Parâmetros

type [in] Um valor da enumeração CorDebugHandleType que especifica o tipo de identificador a ser criado.

ppHandle [out] Um ponteiro para o endereço de um objeto ICorDebugHandleValue que representa o novo identificador para esse valor de heap.

Observações

O identificador será criado no domínio do aplicativo associado ao valor do heap e se tornará inválido se o domínio do aplicativo for descarregado.

Várias chamadas para essa função para o mesmo valor de heap criarão vários identificadores. Como os identificadores afetam o desempenho do coletor de lixo, o depurador deve limitar-se a um número relativamente pequeno de identificadores (cerca de 256) que estão ativos por vez.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: Disponível desde o .NET Framework 2.0