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

Статья
08/07/2023

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

Синтаксис

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	Не ищите имена пакетов MTS.
DEBUG_PROC_DESC_NO_COMMAND_LINE	Не извлекайте командную строку.

[out, optional] ExeName

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

[in] ExeNameSize

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

[out, optional] ActualExeNameSize

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

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

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

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