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

  • [アーティクル]

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

構文

HRESULT GetTrackerDataAsCollectionObject(
  [out] IUnknown **TopLevelCollection
);

パラメーター

[out] TopLevelCollection

返された場合、トラッカー データのコレクションの IUnknown インターフェイス。

戻り値

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

解説

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

アプリケーションでは、このメソッドがサーバーの推奨されるポーリング間隔よりも頻繁に新しく更新された追跡データを返す必要はありません ( 「IGetAppTrackerData::GetSuggestedPollingInterval」を参照してください)。

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

要件

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

関連項目

IGetAppTrackerData