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

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

構文

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

[in] Server

実行可能ファイル名を検索するプロセスサーバーを指定します。 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 内の実行可能ファイル名一致するプロセスはありません。

このメソッドは、ライブユーザーモードデバッグでのみ使用できます。

ライブユーザーモードターゲットの作成とアタッチの詳細については、「Live User-Mode Targets」を参照してください。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)