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 |