Метод IDebugClient8::OpenDumpFileWide2 (dbgeng.h)

Метод OpenDumpFileWide2 открывает файл дампа в качестве целевого объекта отладчика.

Синтаксис

HRESULT OpenDumpFileWide2(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   AlternateArch
);

Параметры

[in, optional] FileName

Указывает имя открываемого файла дампа. Если FileHandle не равно нулю, в этом случае используется имя файла, только если обработчик запрашивает имя файла дампа. имя файла должно включать расширение имени файла. имя_файла может включать относительный или абсолютный путь; относительные пути относятся к каталогу, в котором был запущен отладчик. имя_файла также может находиться в виде URL-адреса файла, начиная с "file://". Если FileName указывает файл шкафа (.cab), файл шкафа выполняет поиск первого файла с расширением Kdmp, затем HDMP, затем MDMP и, наконец, .dmp.

[in] FileHandle

Указывает дескриптор файла дампа, который нужно открыть. Если FileHandle равно нулю, имя_ файла используется для открытия файла дампа. В противном случае, если Имя файла не NULL, подсистема возвращает его при запросе имени файла дампа. Если FileHandle не равно нулю и Имя_файла равно NULL, подсистема возвращает HandleOnly для имени файла.

[in] AlternateArch

Указывает аргумент AlternateArch, являющийся константой IMAGE_FILE_MACHINE_*. Дополнительные сведения см. в разделе Константы файлового компьютера образа.

Поддерживаются эти две константы.

• IMAGE_FILE_MACHINE_AMD64. Загрузка, как если бы образ выполняется в процессе x64

• IMAGE_FILE_MACHINE_ARM64. Загрузка, как если бы образ выполняется в процессе ARM64

Этот параметр имеет значение, только если вы используете OpenDumpFileWide2 для открытия файла образа (а не файла дампа), который можно сопоставить с различными архитектурами. Например, ARM64X, где библиотеку DLL можно загрузить в процесс x64/EC или процесс ARM64.

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

Дополнительные сведения о ARM64X см. в файлах PE Arm64X.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Замечания

Модуль не полностью подключается к файлу дампа до вызова метода WaitForEvent. При создании файла дампа из процесса или ядра сведения о последнем событии хранятся в файле дампа. После открытия файла дампа при следующей попытке выполнения обработчик создаст это событие для обратных вызовов событий. Только после этого файл дампа становится доступным в сеансе отладки.

Дополнительные сведения о файлах аварийного дампа см. в разделе Dump-File Целевые объекты.

Требования

См. также

DEBUG_CLIENT_CONTEXT

IDebugClient8