IDebugClient3：：GetRunningProcessSystemIdByExecutableName 方法 (dbgeng.h)

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

语法

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

[in] Server

指定要搜索可执行文件名称的进程服务器。如果 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 中的可执行文件名称匹配。