IDebugClient4::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

指定需要其说明的进程的进程 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 包名称和命令行。 如果 DescriptionNULL,则不返回此信息。

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

返回值

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

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

注解

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

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

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient3

IDebugClient4

IDebugClient5