Share via


IGetAppTrackerData::GetSuggestedPollingInterval-Methode (comsvcs.h)

Ruft das mindeste Intervall für die vom Tracker-Server vorgeschlagenen Abrufe ab.

Syntax

HRESULT GetSuggestedPollingInterval(
  [out] DWORD *PollingIntervalInSeconds
);

Parameter

[out] PollingIntervalInSeconds

Das vom Tracker-Server vorgeschlagene Abrufintervall in Sekunden.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG und S_OK zurückgeben.

Hinweise

Anwendungen, die Trackerdaten verwenden, müssen in der Regel regelmäßig den Tracker-Server abfragen, um sicherzustellen, dass diese Daten auf dem neuesten Stand sind. Beispielsweise möchte eine administrative Anwendung, die dem Benutzer Überwachungsdaten anzeigt, in der Regel, dass diese Daten in Echtzeit so nah wie möglich sind. Eine zu häufige Abfrage kann jedoch die Gesamtleistung des Systems beeinträchtigen. Beachten Sie auch, dass die COM+-Anwendungen, die die Daten aktualisieren, updates nicht sofort an den Tracker-Server senden, sodass es selbst im besten Fall zu einer Verzögerung kommt (in der Regel nur wenige Sekunden).

Die Abrufhäufigkeit ist eine globale Richtlinie, die Administratoren bei Bedarf anpassen können, um ein Gleichgewicht zwischen Aktualität der Daten und Auswirkungen auf die Leistung für die jeweiligen Tools zu erzielen, die auf den von ihnen verwalteten Systemen verwendet werden. Der in PollingIntervalInSeconds zurückgegebene Wert ist die Mindestdauer, die eine Anwendung nach dem Abrufen von Nachverfolgungsdaten warten sollte, bevor sie einen weiteren Aufruf zum Abrufen der gleichen Daten ausführt. Jede Anwendung, die den Tracker-Server abruft, sollte diese Methode aufrufen und ihr Abrufverhalten entsprechend anpassen.

Das Abrufintervall ist standardmäßig gleich der Häufigkeit des Nachverfolgungsereignisses (drei Sekunden). Dieser Wert kann angepasst werden, indem der folgende REG_DWORD Registrierungswert geschrieben wird:

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3TrackingInfoPollingFrequency = Mindestabrufintervall

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comsvcs.h

Weitere Informationen

IGetAppTrackerData