Método ICorDebugHeapValue2::CreateHandle

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

Sintaxe

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

Parâmetros

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

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

Observações

O identificador será criado no domínio do aplicativo associado ao valor de 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 pilha criarão vários identificadores. Como as alças 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 de cada vez.

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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