IDebugClient2：：GetRunningProcessDescription 方法 (dbgeng.h)

项目
02/27/2024

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

指定需要其说明的进程的进程 ID。

[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

接收用于启动进程的可执行文件的名称。如果 ExeName 为 NULL，则不会返回此信息。

[in] ExeNameSize

指定缓冲区 ExeNameSize 的大小（以字符为单位）。此大小包括“\0”终止字符的空间。

[out, optional] ActualExeNameSize

接收可执行文件名称的大小（以字符为单位）。此大小包括“\0”终止字符的空间。如果 ExeNameSize 为 NULL，则不会返回此信息。

[out, optional] Description

接收有关进程的额外信息，包括服务名称、MTS 包名称和命令行。如果 Description 为 NULL，则不会返回此信息。

[in] DescriptionSize

指定缓冲区说明的大小（以字符为单位）。此大小包括“\0”终止字符的空间。

[out, optional] ActualDescriptionSize

接收额外信息的大小（以字符为单位）。此大小包括“\0”终止字符的空间。如果 ActualDescriptionSize 为 NULL，则不会返回此信息。

返回值

此方法也可能返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。
S_FALSE	方法成功。但是， ExeNameSize 或 DescriptionSize 都小于相应字符串的大小，并且字符串被截断以适合缓冲区内。