Метод IDebugEventCallbacksWide::LoadModule (dbgeng.h)

Статья
02/06/2025

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

Синтаксис

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCWSTR  ModuleName,
  [in, optional] PCWSTR  ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Параметры

[in] ImageFileHandle

Задает дескриптор файла образа модуля. Если эта информация недоступна, ImageFileHandle будет NULL.

[in] BaseOffset

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

[in] ModuleSize

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

[in, optional] ModuleName

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

[in, optional] ImageName

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

[in] CheckSum

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

[in] TimeDateStamp

Указывает метку времени и даты файла образа модуля. Если эта информация недоступна, TimeDateStamp будет равно нулю.

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

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

Замечания

Этот метод вызывается только подсистемой, если флаг DEBUG_EVENT_LOAD_MODULE задан в маске, возвращаемой IDebugEventCallbacksWide::GetInterestMask.

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

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