Interface IGetAppTrackerData (comsvcs.h)

Permet aux applications administratives de récupérer des informations statistiques sur l’exécution d’applications COM+.

Héritage

L’interface IGetAppTrackerData hérite de l’interface IUnknown. IGetAppTrackerData a également les types de membres suivants :

Méthodes

L’interface IGetAppTrackerData contient ces méthodes.

IGetAppTrackerData ::GetApplicationProcessDetails Récupère des informations détaillées sur un processus unique hébergeant des applications COM+.
IGetAppTrackerData ::GetApplicationProcesses Récupère des informations récapitulatives pour tous les processus qui hébergent des applications COM+, ou pour un sous-ensemble spécifié de ces processus.
IGetAppTrackerData ::GetApplicationsInProcess Récupère des informations récapitulatives pour toutes les applications COM+ hébergées dans un processus unique ou pour un sous-ensemble spécifié de ces applications.
IGetAppTrackerData ::GetComponentDetails Récupère des informations détaillées sur un seul composant COM+ hébergé dans un processus.
IGetAppTrackerData ::GetComponentsInProcess Récupère des informations récapitulatives pour tous les composants COM+ hébergés dans un seul processus ou pour un sous-ensemble spécifié de ces composants.
IGetAppTrackerData ::GetSuggestedPollingInterval Récupère l’intervalle minimal d’interrogation suggéré par le serveur de suivi.
IGetAppTrackerData ::GetTrackerDataAsCollectionObject Récupère les données de suivi pour toutes les applications COM+ sous la forme d’un objet de collection.

Remarques

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 DWORD suivante :

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

Configuration requise

Condition requise	Valeur
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