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

Метод GetDumpFile описывает файлы, содержащие вспомогательные сведения, которые использовались при открытии текущего целевого объекта дампа.

Синтаксис

HRESULT GetDumpFile(
  [in]            ULONG    Index,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Handle,
  [out]           PULONG   Type
);

Параметры

[in] Index

Указывает, какой файл следует описать. Индекс может принимать значения от нуля до количества файлов минус один; количество файлов можно найти с помощью getNumberDumpFiles.

[out, optional] Buffer

Получает имя файла. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Задает размер буфера буфера в символах. Этот размер включает пробел для завершающего символа "\0".

[out, optional] NameSize

Получает размер имени файла. Этот размер включает пробел для завершающего символа "\0". Если параметр NameSize имеет значение NULL, эти сведения не возвращаются.

[out, optional] Handle

Получает дескриптор файла. Если handle имеет значение NULL, эти сведения не возвращаются.

[out] Type

Получает тип файла.

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

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

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

Комментарии

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

Требования

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

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

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5