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

Article
08/22/2023

Récupère des informations détaillées sur un processus unique hébergeant des applications COM+.

Syntaxe

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

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 est utilisé pour la sélection à la place.

[in] ProcessId

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

[in] Flags

Combinaison d’indicateurs de l’énumération GetAppTrackerDataFlags qui spécifient les données à retourner. Les indicateurs suivants sont pris en charge : GATD_INCLUDE_PROCESS_EXE_NAME (si vous récupérez un résumé).

[out, optional] Summary

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

[out, optional] Statistics

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

[out, optional] RecycleInfo

Au retour, une structure ApplicationProcessRecycleInfo avec les détails de recyclage du processus. Ce paramètre peut être NULL.

[out, optional] AnyComponentsHangMonitored

Au retour, indique si les composants du processus sont configurés pour l’analyse de blocage. 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 pas d’applications COM+ suivies.

Remarques

Un processus peut être sélectionné par son ID de instance d’application ou 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, comme un argument de ligne de commande pour votre programme.

Vous pouvez demander tout ou partie des informations disponibles pour le processus en transmettant des valeurs non NULL pour Summary, Statistics, RecycleInfo ou AnyComponentsHangMonitored. Au moins l’un de ces paramètres doit être non NULL.

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

Voir aussi

IGetAppTrackerData

Partager via