Метод IDebugClient::OpenDumpFile (dbgeng.h)

Статья
02/06/2025

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

Синтаксис

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Параметры

[in] DumpFile

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

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Версия этого метода Юникода OpenDumpFileWide.

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

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