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

Метод IDebugSystemObjects3::GetCurrentProcessExecutableName (dbgeng.h)

  • Статья

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

Синтаксис

HRESULT GetCurrentProcessExecutableName(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExeSize
);

Параметры

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] ExeSize

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

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

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

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

Комментарии

Эти методы доступны только в пользовательском режиме отладки.

Если обработчик не может определить имя исполняемого файла, он записывает строку "? NoImage?" в буфер.

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

Требования

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