IGetAppTrackerData

管理アプリケーションが、実行中の COM+ アプリケーションに関する統計情報を取得できるようにします。

トラッカーデータを使用するアプリケーションは、通常、このデータを最新の状態に保つために Tracker Server を定期的にポーリングする必要があります。たとえば、トラッキングデータをユーザーに表示する管理アプリケーションでは、通常このデータをできる限りリアルタイムに近い状態にしたいと考えます。しかし、あまりに頻繁にポーリングすると、システム全体のパフォーマンスが低下する可能性があります。また、データを更新する COM+ アプリケーションは Tracker Server に即座に更新を送信するわけではないため、最良の場合でも多少の遅延(通常は数秒程度)が生じることに留意してください。

ポーリング頻度はグローバルなポリシーであり、管理者は、管理対象システムで使用している特定のツールセットについて、データの鮮度とパフォーマンスへの影響のバランスを取るために必要に応じて調整できます。PollingIntervalInSeconds で返される値は、トラッキングデータを取得してから同じデータを取得する次の呼び出しを行うまでにアプリケーションが待機すべき最小時間です。Tracker Server をポーリングするアプリケーションは、このメソッドを呼び出し、それに応じてポーリング動作を調整する必要があります。

ポーリング間隔は既定でトラッキングイベントの頻度(3 秒)と等しくなります。この値は、次の DWORD レジストリ値を書き込むことで調整できます。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3\TrackingInfoPollingFrequency = 最小ポーリング間隔(秒)

COM+ アプリケーションをホストしているすべてのプロセス、または指定したそれらのプロセスのサブセットについて、概要情報を取得します。

このメソッドは、標準の戻り値 E_INVALIDARG および E_OUTOFMEMORY のほか、次の値を返す場合があります。

呼び出し元がトラッキング対象プロセスのサブセットのみの情報を必要とする場合、PartitionId、ApplicationId、Flags の各パラメーターを使用してフィルター条件を指定できます。

Flags に GATD_INCLUDE_LIBRARY_APPS も GATD_INCLUDE_SWC も設定されていない場合、結果には COM+ サーバーアプリケーションのインスタンスのみが含まれます。ApplicationId パラメーターを使用して特定の COM+ サーバーアプリケーションのインスタンスを選択でき、PartitionId パラメーターを使用して特定のパーティションの COM+ サーバーアプリケーションを選択できます。

GATD_INCLUDE_LIBRARY_APPS または GATD_INCLUDE_SWC のいずれかが設定されている場合、結果にはそれぞれ COM+ ライブラリアプリケーションをホストしているプロセス、または Services Without Components コンテキストをホストしているプロセスも含まれます。これらの場合、ApplicationId と PartitionId は、プロセスがホストしている(要求された種類の)すべてのアプリケーションに基づいてプロセスをフィルターします。プロセスに条件に一致するアプリケーションが少なくとも 1 つ含まれている場合、そのプロセスは結果に含まれます。

たとえば、次の COM+ アプリケーションがインストールされているとします。

• AppX は PartitionA のサーバーアプリケーションです。
• AppY は PartitionA のライブラリアプリケーションです。
• AppZ は PartitionB のサーバーアプリケーションです。

• AppX のインスタンスが含まれます。
• AppY のコンポーネントを作成したクライアントプロセスが含まれます。
• 他の COM+ コンポーネントを含まない AppZ のインスタンスは、AppZ が PartitionId で指定されたパーティションに存在しないため、含まれません。
• ただし、AppZ の別のインスタンスがあり、そのインスタンスが AppY のコンポーネントも作成している場合、サーバーアプリケーションが PartitionId で指定されたパーティションに存在しなくても、このプロセスは含まれます。GATD_INCLUDE_LIBRARY_APPS が設定されていなければ、このプロセスは含まれません。

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

このメソッドは、標準の戻り値 E_INVALIDARG および E_OUTOFMEMORY のほか、次の値を返す場合があります。

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

Summary、Statistics、RecycleInfo、AnyComponentsHangMonitored に NULL 以外の値を渡すことで、プロセスについて利用可能な情報の一部またはすべてを要求できます。これらのパラメーターのうち少なくとも 1 つは NULL 以外でなければなりません。

単一のプロセスでホストされているすべての COM+ アプリケーション、または指定したそれらのアプリケーションのサブセットについて、概要情報を取得します。

このメソッドは、標準の戻り値 E_INVALIDARG および E_OUTOFMEMORY のほか、次の値を返す場合があります。

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

Flags に GATD_INCLUDE_LIBRARY_APPS も GATD_INCLUDE_SWC も設定されていない場合、結果には COM+ サーバーアプリケーションのみが含まれます。GATD_INCLUDE_LIBRARY_APPS が設定されている場合、プロセス内の COM+ ライブラリアプリケーション(存在する場合)も含まれます。GATD_INCLUDE_SWC が設定されており、プロセスが 1 つ以上の Services Without Components コンテキストをホストしている場合、結果には SWC コンテキストの概要を示す単一の擬似アプリケーションエントリも含まれます。

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

このメソッドは、標準の戻り値 E_INVALIDARG および E_OUTOFMEMORY のほか、次の値を返す場合があります。

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

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

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

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

このメソッドは、標準の戻り値 E_INVALIDARG および E_OUTOFMEMORY のほか、次の値を返す場合があります。

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

Summary、Statistics、HangMonitorInfo に NULL 以外の値を渡すことで、コンポーネントについて利用可能な情報の一部またはすべてを要求できます。これらのパラメーターのうち少なくとも 1 つは NULL 以外でなければなりません。

すべての COM+ アプリケーションのトラッキングデータを、コレクションオブジェクトの形式で取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、S_OK を返す場合があります。

このメソッドは主に、IComTrackingInfoEvents イベントインターフェイスをサブスクライブするアプリケーションが、コードへの変更を最小限に抑えて IGetAppTrackerData のサポートを追加できるようにすることを目的としています。このメソッドが返すオブジェクトは、サブスクライバーの IComTrackingInfoEvent::OnNewTrackingInfo メソッドの呼び出しで送信されるオブジェクトと同一であるため、このコレクションを走査および解析するコードを再利用できます。

アプリケーションは、このメソッドがサーバーの推奨ポーリング間隔(IGetAppTrackerData::GetSuggestedPollingInterval を参照)よりも頻繁に新しく更新されたトラッキングデータを返すことを期待すべきではありません。

このメソッドが返すコレクションオブジェクトには、他のメソッドを呼び出すことで取得できるすべてのトラッキングデータが含まれるわけではないことに注意してください。特に、リサイクルの詳細とハング監視構成は提供されません。

Tracker Server が推奨する最小ポーリング間隔を取得します。

このメソッドは、標準の戻り値 E_INVALIDARG および S_OK を返す場合があります。

トラッカーデータを使用するアプリケーションは、通常、このデータを最新の状態に保つために Tracker Server を定期的にポーリングする必要があります。たとえば、トラッキングデータをユーザーに表示する管理アプリケーションでは、通常このデータをできる限りリアルタイムに近い状態にしたいと考えます。しかし、あまりに頻繁にポーリングすると、システム全体のパフォーマンスが低下する可能性があります。また、データを更新する COM+ アプリケーションは Tracker Server に即座に更新を送信するわけではないため、最良の場合でも多少の遅延(通常は数秒程度)が生じることに留意してください。

ポーリング頻度はグローバルなポリシーであり、管理者は、管理対象システムで使用している特定のツールセットについて、データの鮮度とパフォーマンスへの影響のバランスを取るために必要に応じて調整できます。PollingIntervalInSeconds で返される値は、トラッキングデータを取得してから同じデータを取得する次の呼び出しを行うまでにアプリケーションが待機すべき最小時間です。Tracker Server をポーリングするアプリケーションは、このメソッドを呼び出し、それに応じてポーリング動作を調整する必要があります。

ポーリング間隔は既定でトラッキングイベントの頻度(3 秒)と等しくなります。この値は、次の REG_DWORD レジストリ値を書き込むことで調整できます。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3\TrackingInfoPollingFrequency = 最小ポーリング間隔