Partager via


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

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