IDebugClient5::GetRunningProcessSystemIdByExecutableName 方法 (dbgeng.h)

GetRunningProcessSystemIdByExecutableName 方法搜索具有给定可执行文件名的进程并返回其进程 ID。

语法

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

参数

[in] Server

指定要搜索可执行文件名称的进程服务器。 如果 服务器 为零,引擎将在本地计算机上运行的进程中搜索可执行文件名称。

[in] ExeName

指定要搜索的可执行文件名称。

[in] Flags

指定一个位集,用于控制可执行文件名称的匹配方式。 可能存在以下标志:

标志 描述
DEBUG_GET_PROC_FULL_MATCH ExeName 指定可执行文件名的完整路径名称。

如果未设置此标志,则此方法在搜索进程时不会使用路径名称。

DEBUG_GET_PROC_ONLY_MATCH 要求只有一个进程与可执行文件名 ExeName 匹配。

[out] Id

接收与 ExeName 匹配的第一个进程的进程 ID。

返回值

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

返回代码 说明
S_OK
该方法成功。
S_FALSE
多个进程匹配 ExeName 中的可执行文件名称,并在 Flags 中设置了DEBUG_GET_PROC_ONLY_MATCH。
E_NOINTERFACE
没有进程匹配 ExeName 中的可执行文件名。

备注

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

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

要求

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

另请参阅

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5