IDebugClient3：：GetRunningProcessSystemIdByExecutableNameWide 方法 (dbgeng.h)

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

語法

HRESULT GetRunningProcessSystemIdByExecutableNameWide(
  [in]  ULONG64 Server,
  [in]  PCWSTR  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。

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

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