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

Статья
02/23/2024

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

Синтаксис

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

Параметры

[in, optional] FileName

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

[in] FileHandle

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

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

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

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

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

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