Метод ICorDebugModule3::CreateReaderForInMemorySymbols

Статья
11/05/2024

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

Синтаксис

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).

Требования

Платформы: см. раздел Требования к системе.

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

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

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

Поделиться через