IDebugClient2：：GetRunningProcessSystemIdByExecutableName 方法（dbgeng.h）

GetRunningProcessSystemIdByExecutableName 方法會搜尋具有指定可執行檔名稱的進程，並傳回其進程標識符。

語法

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。

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	方法成功。
S_FALSE	多個進程符合 ExeName中的可執行檔名稱，且DEBUG_GET_PROC_ONLY_MATCH已在 Flags中設定。
E_NOINTERFACE	沒有進程符合 ExeName中的可執行檔名稱。