Метод IDebugClient5::GetRunningProcessDescriptionWide (dbgeng.h)
Метод GetRunningProcessDescriptionWide возвращает описание процесса, включающее имя исполняемого образа, имена служб, имена пакетов MTS и командную строку.
Синтаксис
HRESULT GetRunningProcessDescriptionWide(
[in] ULONG64 Server,
[in] ULONG SystemId,
[in] ULONG Flags,
[out, optional] PWSTR ExeName,
[in] ULONG ExeNameSize,
[out, optional] PULONG ActualExeNameSize,
[out, optional] PWSTR 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, эта информация не возвращается.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Метод выполнен успешно. Однако exeNameSize или DescriptionSize были меньше размера соответствующей строки, и строка была усечена для размещения внутри буфера. |
Комментарии
Этот метод доступен только для динамической отладки в пользовательском режиме.
Дополнительные сведения о создании и подключении к динамическим целевым объектам пользовательского режима см. в разделе Live User-Mode Targets.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по