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

  • [アーティクル]

プロセスでホストされている 1 つの COM+ コンポーネントに関する詳細情報を取得します。

構文

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

パラメーター

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] Clsid

コンポーネントの CLSID。

[in] Flags

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

[out] Summary

返された場合、コンポーネントの概要情報を含む ComponentSummary 構造体。 このパラメーターは、NULL でもかまいません。

[out] Statistics

返された場合、コンポーネントの統計を含む ComponentStatistics 構造体。 このパラメーターは、NULL でもかまいません。

[out] HangMonitorInfo

返された場合、コンポーネントのハング監視構成を持つ ComponentHangMonitorInfo 構造体。 このパラメーターは、NULL でもかまいません。

戻り値

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

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

解説

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

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

要件

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

関連項目

IGetAppTrackerData