Méthode IGetAppTrackerData::GetSuggestedPollingInterval (comsvcs.h)

  • Article

Récupère l’intervalle minimal d’interrogation suggéré par le serveur de suivi.

Syntaxe

HRESULT GetSuggestedPollingInterval(
  [out] DWORD *PollingIntervalInSeconds
);

Paramètres

[out] PollingIntervalInSeconds

Intervalle d’interrogation suggéré du serveur de suivi, en secondes.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG et S_OK.

Notes

Les applications qui utilisent des données de suivi doivent généralement interroger régulièrement le serveur de suivi pour s’assurer que ces données sont à jour. Par exemple, une application administrative qui affiche des données de suivi à l’utilisateur souhaite généralement que ces données soient aussi proches que possible du temps réel. Toutefois, l’interrogation trop fréquente peut dégrader les performances globales du système. Gardez également à l’esprit que les applications COM+ qui mettent à jour les données n’envoient pas de mises à jour immédiatement au serveur de suivi, de sorte que même dans le meilleur des cas, il y aura un certain délai (généralement seulement quelques secondes).

La fréquence d’interrogation est une stratégie globale que les administrateurs peuvent ajuster, si nécessaire, pour équilibrer l’actualisation des données et l’impact sur les performances pour l’ensemble particulier d’outils en cours d’utilisation sur les systèmes qu’ils gèrent. La valeur retournée dans PollingIntervalInSeconds est la durée minimale pendant laquelle une application doit attendre après avoir récupéré les données de suivi avant d’effectuer un autre appel pour récupérer les mêmes données. Toute application qui interroge le serveur de suivi doit appeler cette méthode et ajuster son comportement d’interrogation en conséquence.

L’intervalle d’interrogation est par défaut égal à la fréquence de l’événement de suivi (trois secondes). Cette valeur peut être ajustée en écrivant la valeur de Registre REG_DWORD suivante :

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3TrackingInfoPollingFrequency = intervalle d’interrogation minimal

Spécifications

   
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible Windows
En-tête comsvcs.h

Voir aussi

IGetAppTrackerData