Метод ICorDebugModule3::CreateReaderForInMemorySymbols

Создает средство чтения символов отладки для динамического модуля.

Синтаксис

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

Параметры

riid
[in] Идентификатор IID интерфейса COM для возврата. Как правило, это интерфейс ISymUnmanagedReader.

ppObj
[out] Указатель на указатель на возвращаемый интерфейс.

Возвращаемое значение

S_OK
Успешно создан модуль чтения.

CORDBG_E_MODULE_LOADED_FROM_DISK
Модуль не является в памяти или динамическим модулем.

CORDBG_E_SYMBOLS_NOT_AVAILABLE
Символы не были предоставлены приложением или еще недоступны.

E_FAIL (или другие E_ коды возврата)
Не удалось создать средство чтения.

Замечания

Этот метод также можно использовать для создания объекта чтения символов для модулей в памяти (нединамических), но только после того, как символы впервые доступны (указываются обратным вызовом метода UpdateModuleSymbols ).

Этот метод возвращает новый экземпляр средства чтения при каждом вызове (например , CComPtrBase::CoCreateInstance). Поэтому отладчик должен кэшировать результат и запрашивать новый экземпляр, только если базовые данные могут измениться (то есть при получении обратного вызова метода LoadClass ).

Динамические модули не имеют символов, доступных до загрузки первого типа (как указано обратным вызовом метода LoadClass ).

Требования

Платформ: См. сведения о поддерживаемых операционных системах .NET.

Заголовок: CorDebug.idl, CorDebug.h

Библиотека: CorGuids.lib

Версии .NET: 4.5, 4, 3.5 с пакетом обновления 1 (SP1)

См. также

• Интерфейс ICorDebugRemoteTarget
• Интерфейс ICorDebug