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

Article
08/22/2023

Récupère des informations récapitulatives pour tous les composants COM+ hébergés dans un seul processus, ou pour un sous-ensemble spécifié de ces composants.

Syntaxe

HRESULT GetComponentsInProcess(
  [in]  REFGUID          ApplicationInstanceId,
  [in]  DWORD            ProcessId,
  [in]  REFGUID          PartitionId,
  [in]  REFGUID          ApplicationId,
  [in]  DWORD            Flags,
  [out] ULONG            *NumComponentsInProcess,
  [out] ComponentSummary **Components
);

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 le paramètre 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] ApplicationId

ID d’application pour filtrer les résultats ou GUID_NULL pour toutes les applications.

[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_CLASS_NAME GATD_INCLUDE_APPLICATION_NAME. Pour plus d’informations, consultez la section Remarques ci-dessous.

[out] NumComponentsInProcess

Au retour, le nombre de composants du processus qui correspondent aux critères de filtre spécifiés par PartitionId, ApplicationId et Flags.

[out] Components

Au retour, un tableau de structures ComponentSummary pour les composants correspondants.

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 Components .
S_FALSE	La méthode s’est terminée correctement, mais aucun composant 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, seuls les composants de l’application serveur COM+ sont inclus dans les résultats. Si GATD_INCLUDE_LIBRARY_APPS est défini, les composants des applications de bibliothèque COM+ dans le processus, le cas échéant, sont également inclus. Si GATD_INCLUDE_SWC est défini, les résultats incluent également des entrées pour les contextes Services sans composants.

Si ApplicationId est utilisé pour spécifier une application (il n’est pas défini sur GUID_NULL), les indicateurs GATD_INCLUDE_LIBRARY_APPS et GATD_INCLUDE_SWC ne sont pas significatifs et il n’est pas valide de les utiliser. Les composants de l’application spécifiée sont retournés, quel que soit le type de cette application.

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