IDebugClient：：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

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

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

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