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

  • Article

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.

Syntaxe

HRESULT GetApplicationsInProcess(
  [in]  REFGUID            ApplicationInstanceId,
  [in]  DWORD              ProcessId,
  [in]  REFGUID            PartitionId,
  [in]  DWORD              Flags,
  [out] ULONG              *NumApplicationsInProcess,
  [out] ApplicationSummary **Applications
);

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] PartitionId

ID de partition pour filtrer les résultats ou GUID_NULL pour toutes les partitions.

[in] Flags

Combinaison d’indicateurs de l’énumération GetAppTrackerDataFlags pour filtrer les résultats et sélectionner les données retournées. Les indicateurs suivants sont pris en charge : GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC GATD_INCLUDE_APPLICATION_NAME. Pour plus d’informations, consultez la section Remarques ci-dessous.

[out] NumApplicationsInProcess

Au retour, nombre d’applications dans le processus qui correspondent aux critères de filtre spécifiés par PartitionId et Flags.

[out] Applications

Au retour, tableau de structures ApplicationSummary pour les applications correspondantes.

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 méthode s’est terminée correctement et les résultats se trouvent dans le paramètre Applications .
S_FALSE
 La méthode s’est terminée correctement, mais aucun processus ne correspondait aux critères de filtre.
COMADMIN_E_APP_NOT_RUNNING
 Le processus spécifié n’existe pas ou n’héberge aucune application COM+ suivie.

Remarques

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.

Si ni GATD_INCLUDE_LIBRARY_APPS ni GATD_INCLUDE_SWC ne sont définis dans Indicateurs, seule l’application serveur COM+ est incluse dans les résultats. Si GATD_INCLUDE_LIBRARY_APPS est défini, les applications de bibliothèque COM+ dans le processus, le cas échéant, sont également incluses. Si GATD_INCLUDE_SWC est défini et que le processus héberge un ou plusieurs contextes Services sans composants, les résultats incluent également une seule pseudo-entrée d’application avec un résumé des contextes SWC.

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