Метод IDebugClient4::GetRunningProcessDescription (dbgeng.h)

Статья
08/07/2023

Метод GetRunningProcessDescription возвращает описание процесса, включающее имя исполняемого образа, имена служб, имена пакетов ВСП и командную строку.

Синтаксис

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

Параметры

[in] Server

Указывает сервер обработки для запроса описания процесса. Если значение Server равно нулю, подсистема будет запрашивать сведения о локальном процессе напрямую.

[in] SystemId

Указывает идентификатор процесса, описание которого необходимо.

[in] Flags

Задает битовый набор, содержащий параметры, влияющие на поведение этого метода. Флаги могут содержать следующие битовые флаги:

Flag	Описание
DEBUG_PROC_DESC_NO_PATHS	Возвращает только имена файлов без имен пути.
DEBUG_PROC_DESC_NO_SERVICES	Не ищите имена служб.
DEBUG_PROC_DESC_NO_MTS_PACKAGES	Не ищите имена пакетов ВСП.
DEBUG_PROC_DESC_NO_COMMAND_LINE	Не извлекайте командную строку.

[out, optional] ExeName

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

[in] ExeNameSize

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

[out, optional] ActualExeNameSize

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

[out, optional] Description

Получает дополнительную информацию о процессе, в том числе имена служб, имена пакетов СБОРОК и командную строку. Если параметр Description имеет значение NULL, эта информация не возвращается.

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

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

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

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