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

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

Синтаксис

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

Параметры

[in, optional] FileName

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

[in] FileHandle

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

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

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

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

Замечания

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

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

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include Dbgeng.h)

См. также

.opendump (Open Dump File)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient4

IDebugClient5

OpenDumpFile

  • Last updated on