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

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

Синтаксис

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Параметры

[in] DumpFile

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

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.

Комментарии

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

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

Требования

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

См. также раздел

.opendump (Open Dump File)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OpenDumpFileWide