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

Статья
06.02.2025

Метод 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

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

[in] BufferSize

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

[out, optional] NameSize

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

[out, optional] Handle

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

[out] Type

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

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

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

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

Замечания

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

Требования

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

См. также

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5

Поделиться через