Compartilhar via

Método ICorDebugModule3::CreateReaderForInMemorySymbols

Cria um leitor de símbolo de depuração para um módulo dinâmico.

Sintaxe

HRESULT CreateReaderForInMemorySymbols (
      [in] REFIID riid,
      [out][iid_is(riid)] void **    ppObj

Parâmetros

riid
[in] A IID da interface COM a ser retornada. Normalmente, essa é uma interface ISymUnmanagedReader.

ppObj
[out] Ponteiro para um ponteiro para a interface retornada.

Valor de retorno

S_OK
O leitor foi criado com êxito.

CORDBG_E_MODULE_LOADED_FROM_DISK
O módulo não é um módulo dinâmico ou na memória.

CORDBG_E_SYMBOLS_NOT_AVAILABLE
Os símbolos não foram fornecidos pelo aplicativo ou ainda não estão disponíveis.

E_FAIL (ou outros E_ códigos de retorno)
Não é possível criar o leitor.

Observações

Esse método também pode ser usado para criar um objeto de leitor de símbolos para módulos na memória (não dinâmicos), mas somente depois que os símbolos estiverem disponíveis pela primeira vez (indicado pelo retorno de chamada do Método UpdateModuleSymbols ).

Esse método retorna uma nova instância de leitor sempre que é chamada (como CComPtrBase::CoCreateInstance). Portanto, o depurador deve armazenar em cache o resultado e solicitar uma nova instância somente quando os dados subjacentes puderem ter sido alterados (ou seja, quando um retorno de chamada do Método LoadClass for recebido).

Os módulos dinâmicos não têm nenhum símbolo disponível até que o primeiro tipo tenha sido carregado (conforme indicado pelo retorno de chamada do Método LoadClass ).

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: 4.5, 4, 3.5 SP1

Consulte também

  • Last updated on