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

Article
08/22/2023

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

Partager via