IDebugClient2::GetRunningProcessDescription メソッド (dbgeng.h)

[アーティクル]
02/06/2025

GetRunningProcessDescription メソッドは、実行可能イメージ名、サービス名、MTS パッケージ名、およびコマンドラインを含むプロセスの説明を返します。

構文

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

パラメーター

[in] Server

プロセスの説明を照会するプロセスサーバーを指定します。 Server が 0 の場合、エンジンはローカルプロセスに関する情報を直接照会します。

[in] SystemId

説明が必要なプロセスのプロセス ID を指定します。

[in] Flags

このメソッドの動作に影響するオプションを含むビットセットを指定します。 Flags には、次のビットフラグを含めることができます。

旗	形容
DEBUG_PROC_DESC_NO_PATHS	パス名のないファイル名のみを返します。
DEBUG_PROC_DESC_NO_SERVICES	サービス名を検索しないでください。
DEBUG_PROC_DESC_NO_MTS_PACKAGES	MTS パッケージ名を検索しないでください。
DEBUG_PROC_DESC_NO_COMMAND_LINE	コマンドラインを取得しないでください。

[out, optional] ExeName

プロセスの開始に使用される実行可能ファイルの名前を受け取ります。 ExeName が NULL 場合、この情報は返されません。

[in] ExeNameSize

ExeNameSize のバッファーのサイズ文字数で指定します。このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] ActualExeNameSize

実行可能ファイル名のサイズを文字数で受け取ります。このサイズには、'\0' 終端文字のスペースが含まれます。 ExeNameSize が NULL 場合、この情報は返されません。

[out, optional] Description

サービス名、MTS パッケージ名、コマンドラインなど、プロセスに関する追加情報を受け取ります。 Description が NULL 場合、この情報は返されません。

[in] DescriptionSize

バッファー Descriptionのサイズを文字数で指定します。このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] ActualDescriptionSize

追加情報のサイズ (文字数) を受け取ります。このサイズには、'\0' 終端文字のスペースが含まれます。 ActualDescriptionSize が NULL 場合、この情報は返されません。

戻り値

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

リターンコード	形容
S_OK	メソッドが成功しました。
S_FALSE	メソッドが成功しました。ただし、ExeNameSize または DescriptionSize は、それぞれの文字列のサイズよりも小さく、バッファー内に収まるように文字列が切り捨てられました。

備考

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

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

必要条件

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

次の方法で共有

IDebugClient2::GetRunningProcessDescription メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース