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

1 つのプロセスでホストされているすべての COM+ コンポーネント、またはこれらのコンポーネントの指定されたサブセットの概要情報を取得します。

構文

HRESULT GetComponentsInProcess(
  [in]  REFGUID          ApplicationInstanceId,
  [in]  DWORD            ProcessId,
  [in]  REFGUID          PartitionId,
  [in]  REFGUID          ApplicationId,
  [in]  DWORD            Flags,
  [out] ULONG            *NumComponentsInProcess,
  [out] ComponentSummary **Components
);

パラメーター

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] PartitionId

結果をフィルター処理するパーティション ID、またはすべてのパーティションのGUID_NULL。

[in] ApplicationId

結果をフィルター処理するアプリケーション ID、またはすべてのアプリケーションのGUID_NULL。

[in] Flags

GetAppTrackerDataFlags 列挙のフラグを組み合わせて結果をフィルター処理し、返されるデータを選択します。 次のフラグがサポートされています: GATD_INCLUDE_LIBRARY_APPS、GATD_INCLUDE_SWC、GATD_INCLUDE_CLASS_NAME、GATD_INCLUDE_APPLICATION_NAME。 詳細については、以下の「備考」を参照してください。

[out] NumComponentsInProcess

返された場合、 PartitionId、 ApplicationId、 および Flags で指定されたフィルター条件に一致するプロセス内のコンポーネントの数。

[out] Components

返された場合、一致する コンポーネントの ComponentSummary 構造体の配列。

戻り値

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

注釈

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

フラグにGATD_INCLUDE_LIBRARY_APPSもGATD_INCLUDE_SWCも設定されていない場合は、COM+ サーバー アプリケーションのコンポーネントのみが結果に含まれます。 GATD_INCLUDE_LIBRARY_APPSが設定されている場合は、プロセス内の COM+ ライブラリ アプリケーションのコンポーネント (存在する場合) も含まれます。 GATD_INCLUDE_SWCが設定されている場合、結果には [コンポーネントなしサービス] コンテキストのエントリも含まれます。

ApplicationId を使用してアプリケーションを指定する場合 (GUID_NULLに設定されていません)、GATD_INCLUDE_LIBRARY_APPSフラグとGATD_INCLUDE_SWC フラグは意味を持たず、使用しても無効です。 指定したアプリケーションのコンポーネントは、そのアプリケーションの種類に関係なく返されます。

要件

こちらもご覧ください

IGetAppTrackerData