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

トラッカー サーバーによって提案されたポーリングの最小間隔を取得します。

構文

HRESULT GetSuggestedPollingInterval(
  [out] DWORD *PollingIntervalInSeconds
);

パラメーター

[out] PollingIntervalInSeconds

トラッカー サーバーの推奨されるポーリング間隔 (秒単位)。

戻り値

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

解説

通常、トラッカー データを使用するアプリケーションでは、このデータが最新であることを確認するために、トラッカー サーバーを定期的にポーリングする必要があります。 たとえば、ユーザーに追跡データを表示する管理アプリケーションでは、通常、このデータを可能な限りリアルタイムに近いものにしたいと考えています。 ただし、ポーリングの頻度が高すぎると、システム全体のパフォーマンスが低下する可能性があります。 また、データを更新する COM+ アプリケーションは、すぐにトラッカー サーバーに更新プログラムを送信しないため、最良の場合でも、ある程度の遅延 (通常は数秒のみ) が発生することに注意してください。

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

ポーリング間隔は、既定では追跡イベントの頻度 (3 秒) と等しくなります。 この値は、次のREG_DWORDレジストリ値を記述することで調整できます。

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

要件

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

関連項目

IGetAppTrackerData