Compartilhar via

Método ICorDebugHeapValue2::CreateHandle

  • Artigo

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 [em] Um valor da enumeração CorDebugHandleType que especifica o tipo de identificador a ser criado.

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

Comentários

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 a 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) ativos por vez.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0