IDebugClient2::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中的可執行檔名稱。

備註

這個方法僅適用于即時使用者模式偵錯。

如需建立和附加至即時使用者模式目標的詳細資訊,請參閱 即時User-Mode目標

必要條件

   
目標平臺 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5