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

Статья
09/24/2022
Чтение занимает 2 мин

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

Синтаксис

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

Параметры

[in, optional] FileName

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

[in] FileHandle

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

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

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

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

Примечания

Версия этого метода ASCII — OpenDumpFile.

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

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