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

Метод IDebugEventCallbacks::UnloadModule (dbgeng.h)

  • Статья

Метод обратного вызова UnloadModule вызывается подсистемой при возникновении события отладки module-unload в целевом объекте.

Синтаксис

HRESULT UnloadModule(
  [in, optional] PCSTR   ImageBaseName,
  [in]           ULONG64 BaseOffset
);

Параметры

[in, optional] ImageBaseName

Указывает имя файла изображения модуля, которое может содержать путь. Если эти сведения недоступны, ImageBaseName будет иметь значение NULL.

[in] BaseOffset

Указывает базовый адрес модуля в адресном пространстве целевой памяти. Если эти сведения недоступны, baseOffset будет иметь значение NULL.

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

Этот метод возвращает значение DEBUG_STATUS_XXX , указывающее, как должно происходить выполнение целевого объекта после обработки обработчиком этого события. Дополнительные сведения о том, как подсистема обрабатывает это значение, см. в разделе Мониторинг событий.

Комментарии

Этот метод вызывается обработчиком только в том случае, если флаг DEBUG_EVENT_UNLOAD_MODULE установлен в маске, возвращаемой IDebugEventCallbacks::GetInterestMask.

После вызова этого метода подсистема вызовет IDebugEventCallbacks::ChangeSymbolState с параметром Flags, содержащим битовый флаг DEBUG_CSS_UNLOADS.

Дополнительные сведения об обработке событий см. в разделе События мониторинга.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)