IDebugProgramProvider2::GetProviderProcessData
指定されたプロセスから、実行中のプログラムの一覧を取得します。
構文
int GetProviderProcessData(
enum_PROVIDER_FLAGS Flags,
IDebugDefaultPort2 pPort,
AD_PROCESS_ID ProcessId,
CONST_GUID_ARRAY EngineFilter,
PROVIDER_PROCESS_DATA[] pProcess
);
パラメーター
Flags
[入力] PROVIDER_FLAGS 列挙型のフラグの組み合わせ。 この呼び出しで一般的なフラグは、次のとおりです。
| フラグ | 説明 |
|---|---|
PFLAG_REMOTE_PORT |
呼び出し元はリモート コンピューターで実行されています。 |
PFLAG_DEBUGGEE |
呼び出し元は現在、デバッグ中です (マーシャリングに関する追加情報がノードごとに返されます)。 |
PFLAG_ATTACHED_TO_DEBUGGEE |
呼び出し元はアタッチされましたが、デバッガーによって起動されませんでした。 |
PFLAG_GET_PROGRAM_NODES |
呼び出し元が、返されるプログラム ノードの一覧を要求しています。 |
pPort
[入力] 呼び出しプロセスが実行されているポート。
processId
[入力] 対象のプログラムを含むプロセスの ID を保持している AD_PROCESS_ID 構造体。
EngineFilter
[入力] このプロセスのデバッグ割り当てられたデバッグ エンジンの GUID の配列 (これらは、指定されたエンジンがサポートしているものに基づいて実際に返されるプログラムをフィルター処理するために使用されます。エンジンが指定されていない場合は、すべてのプログラムが返されます)。
pProcess
[出力] 要求された情報が格納される PROVIDER_PROCESS_DATA 構造体。
戻り値
成功した場合は、S_OK を返します。それ以外の場合は、エラー コードを返します。
解説
通常、このメソッドはプロセスによって呼び出され、そのプロセスで実行されているプログラムの一覧を取得します。 返される情報は、IDebugProgramNode2 オブジェクトの一覧です。