IGetAppTrackerData::GetApplicationProcessDetails メソッド (comsvcs.h)

  • [アーティクル]

COM+ アプリケーションをホストする 1 つのプロセスに関する詳細情報を取得します。

構文

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

パラメーター

[in] ApplicationInstanceId

選択する追跡対象のプロセスを一意に識別するアプリケーション インスタンス GUID。代わりに ProcessId パラメーターを選択に使用する場合はGUID_NULL。

[in] ProcessId

選択するプロセスを識別するプロセス ID。代わりに ApplicationInstanceId パラメーターを選択に使用する場合は 0。

[in] Flags

返されるデータを指定する GetAppTrackerDataFlags 列挙からのフラグの組み合わせ。 次のフラグがサポートされています: GATD_INCLUDE_PROCESS_EXE_NAME (概要を取得する場合)。

[out, optional] Summary

返された場合、プロセスの概要情報を含む ApplicationProcessSummary 構造体。 このパラメーターは、NULL でもかまいません。

[out, optional] Statistics

返された場合、プロセスの統計を含む ApplicationProcessStatistics 構造体。 このパラメーターは、NULL でもかまいません。

[out, optional] RecycleInfo

返された場合、プロセスのリサイクルの詳細を含む ApplicationProcessRecycleInfo 構造体。 このパラメーターは、NULL でもかまいません。

[out, optional] AnyComponentsHangMonitored

戻り時に、 は、プロセス内のコンポーネントがハング監視用に構成されているかどうかを示します。 このパラメーターは、NULL でもかまいません。

戻り値

このメソッドは、E_INVALIDARGおよびE_OUTOFMEMORY標準の戻り値と、次の値を返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
COMADMIN_E_APP_NOT_RUNNING
 指定されたプロセスが存在しないか、追跡対象の COM+ アプリケーションをホストしていません。

注釈

プロセスは、アプリケーション インスタンス ID またはそのプロセス ID によって選択できますが、両方で選択することはできません。 プロセス ID はプロセスの終了後に再利用される可能性があるため、一般に、アプリケーション インスタンス ID による選択が推奨されます。 ただし、プロセス ID による選択は、プログラムへのコマンド ライン引数など、他のソースからプロセス ID を取得する場合に役立ちます。

Summary、Statistics、RecycleInfo、または AnyComponentsHangMonitored に NULL 以外の値を渡すことで、プロセスで使用できる情報の一部またはすべてを要求できます。 これらのパラメーターのうち少なくとも 1 つは NULL 以外である必要があります。

要件

要件 値
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー comsvcs.h

こちらもご覧ください

IGetAppTrackerData