Метод IDebugSymbols3::GetImagePath (dbgeng.h)

  • Статья

Метод GetImagePath возвращает путь к исполняемому образу.

Синтаксис

HRESULT GetImagePath(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG PathSize
);

Параметры

[out, optional] Buffer

Получает путь к исполняемому образу. Это строка, содержащая каталоги, разделенные точкой с запятой (;). Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

Указывает размер буфера буфера буфера (в символах).

[out, optional] PathSize

Получает размер (в символах) пути к исполняемому изображению.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
S_FALSE
 Метод выполнен успешно. Однако буфер не был достаточно большим, чтобы вместить путь к исполняемому образу, и путь был усечен.

Комментарии

Путь к исполняемому образу используется подсистемой при поиске исполняемых образов.

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

Требования

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

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

AppendImagePath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

SetImagePath