IDebugClient：：GetRunningProcessSystemIdByExecutableName 方法 (dbgeng.h)

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

語法

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 之第一個進程的進程識別碼。

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

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