IDebugClient5::GetRunningProcessSystemIdByExecutableName メソッド (dbgeng.h)

GetRunningProcessSystemIdByExecutableName メソッドは、特定の実行可能ファイル名を持つプロセスを検索し、そのプロセス ID を返します。

構文

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

[in] Server

実行可能ファイル名を検索するプロセスサーバーを指定します。 サーバーが 0 の場合、エンジンはローカルコンピューターで実行されているプロセスの中から実行可能ファイル名を検索します。

[in] ExeName

検索する実行可能ファイル名を指定します。

[in] Flags

実行可能ファイル名の照合方法を制御するビットセットを指定します。次のフラグが存在する場合があります。

フラグ	説明
DEBUG_GET_PROC_FULL_MATCH	ExeName は、実行可能ファイル名の完全なパス名を指定します。このフラグが設定されていない場合、このメソッドはプロセスを検索するときにパス名を使用しません。
DEBUG_GET_PROC_ONLY_MATCH	実行可能ファイル名 ExeName と一致するプロセスは 1 つだけ必要です。

[out] Id

ExeName と一致する最初のプロセスのプロセス ID を受け取ります。

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。
S_FALSE	複数のプロセスが ExeName の実行可能ファイル名と一致し、DEBUG_GET_PROC_ONLY_MATCH が Flags に設定されました。
E_NOINTERFACE	ExeName の実行可能ファイル名と一致するプロセスはありません。