Partager via


IGetAppTrackerData::GetComponentDetails, méthode (comsvcs.h)

Récupère des informations détaillées sur un seul composant COM+ hébergé dans un processus.

Syntaxe

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

Paramètres

[in] ApplicationInstanceId

L’application instance GUID qui identifie de manière unique le processus suivi à sélectionner, ou GUID_NULL si le paramètre ProcessId sera utilisé pour la sélection à la place.

[in] ProcessId

ID de processus qui identifie le processus à sélectionner, ou 0 si ApplicationInstanceId sera utilisé pour la sélection à la place.

[in] Clsid

CLSID du composant.

[in] Flags

Combinaison d’indicateurs de l’énumération GetAppTrackerDataFlags pour sélectionner les données retournées. Les indicateurs suivants sont pris en charge : GATD_INCLUDE_CLASS_NAME (si vous récupérez un résumé), GATD_INCLUDE_APPLICATION_NAME (si vous récupérez un résumé).

[out] Summary

Au retour, une structure ComponentSummary avec des informations récapitulatives pour le composant. Ce paramètre peut être NULL.

[out] Statistics

Au retour, une structure ComponentStatistics avec des statistiques pour le composant. Ce paramètre peut être NULL.

[out] HangMonitorInfo

Au retour, une structure ComponentHangMonitorInfo avec une configuration de supervision de blocage pour le composant. Ce paramètre peut être NULL.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG et E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
La commande s'est correctement terminée.
COMADMIN_E_APP_NOT_RUNNING
Le processus spécifié n’existe pas ou n’héberge aucune application COM+ suivie.
COMADMIN_E_OBJECT_DOES_NOT_EXIST
Le composant spécifié n’existe pas dans le processus spécifié.

Notes

Un processus peut être sélectionné par son ID de instance d’application ou par son ID de processus, mais pas par les deux. La sélection par id de instance d’application est généralement recommandée, car les ID de processus peuvent être réutilisés après l’arrêt d’un processus. Toutefois, la sélection par ID de processus peut être utile si vous obtenez l’ID de processus à partir d’une autre source, telle qu’un argument de ligne de commande pour votre programme.

Vous pouvez demander une partie ou la totalité des informations disponibles pour le composant en transmettant des valeurs non NULL pour Summary, Statistics ou HangMonitorInfo. Au moins l’un de ces paramètres doit être non NULL.

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