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

Статья
02/06/2025

Метод GetRunningProcessDescript ion возвращает описание процесса, включающего имя исполняемого образа, имена служб, имена пакетов ML и командную строку.

Синтаксис

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

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

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

[out, optional] ExeName

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

[in] ExeNameSize

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

[out, optional] ActualExeNameSize

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

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

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

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