IDebugClient5::GetRunningProcessDescription 方法 (dbgeng.h)

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

指定要查询进程说明的进程服务器。 如果 服务器 为零,则引擎将直接查询有关本地进程的信息。

[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

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

[in] ExeNameSize

指定缓冲区 ExeNameSize 的字符大小。 此大小包括“\0”终止字符的空间。

[out, optional] ActualExeNameSize

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

[out, optional] Description

接收有关该过程的额外信息,包括服务名称、MTS 包名称和命令行。 如果 说明NULL,则不会返回此信息。

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

接收额外信息的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。 如果 ActualDescriptionSizeNULL,则不会返回此信息。

返回值

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

返回代码 说明
S_OK
该方法成功。
S_FALSE
该方法成功。 但是, ExeNameSizeDescriptionSize 都小于相应字符串的大小,字符串被截断以适合缓冲区内。

注解

此方法仅适用于实时用户模式调试。

有关创建和附加到实时用户模式目标的详细信息,请参阅 实时User-Mode目标

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

另请参阅

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5