Compartir a través de

Método IGetAppTrackerData::GetApplicationProcesses (comsvcs.h)

  • Artículo

Recupera información de resumen de todos los procesos que hospedan aplicaciones COM+ o para un subconjunto especificado de estos procesos.

Sintaxis

HRESULT GetApplicationProcesses(
  [in]  REFGUID                   PartitionId,
  [in]  REFGUID                   ApplicationId,
  [in]  DWORD                     Flags,
  [out] ULONG                     *NumApplicationProcesses,
  [out] ApplicationProcessSummary **ApplicationProcesses
);

Parámetros

[in] PartitionId

Identificador de partición para filtrar los resultados o GUID_NULL para todas las particiones.

[in] ApplicationId

Identificador de aplicación para filtrar los resultados o GUID_NULL para todas las aplicaciones.

[in] Flags

Combinación de marcas de la enumeración GetAppTrackerDataFlags para filtrar los resultados y seleccionar qué datos se devuelven. Se admiten las marcas siguientes: GATD_INCLUDE_PROCESS_EXE_NAME, GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC. Consulte los comentarios siguientes para obtener más información.

[out] NumApplicationProcesses

A cambio, el número de procesos que coinciden con los criterios de filtro especificados por PartitionId, ApplicationId y Flags.

[out] ApplicationProcesses

A cambio, una matriz de estructuras ApplicationProcessSummary para los procesos coincidentes.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG y E_OUTOFMEMORY, así como los valores siguientes.

Código devuelto Descripción
S_OK
 El método se completó correctamente y los resultados se encuentran en el parámetro ApplicationProcesses .
S_FALSE
 El método se completó correctamente, pero no había ningún proceso que coincida con los criterios de filtro.

Comentarios

Los parámetros PartitionId, ApplicationId y Flags se pueden usar para especificar criterios de filtro si el autor de la llamada solo quiere información sobre un subconjunto de procesos de seguimiento.

Si ni GATD_INCLUDE_LIBRARY_APPS ni GATD_INCLUDE_SWC se establecen en Marcas, los resultados incluyen solo instancias de aplicación de servidor COM+. El parámetro ApplicationId se puede usar para seleccionar instancias de una aplicación de servidor COM+ específica y el parámetro PartitionId para aplicaciones de servidor COM+ desde una partición específica.

Si se establecen GATD_INCLUDE_LIBRARY_APPS o GATD_INCLUDE_SWC, los resultados también incluyen procesos que hospedan aplicaciones de biblioteca COM+ o servicios sin contextos de componentes, respectivamente. En estos casos, los procesos de filtro ApplicationId y PartitionId se basan en todas las aplicaciones (de los tipos solicitados) que hospeda el proceso. Si un proceso incluye al menos una aplicación que coincida con los criterios, se incluirá en los resultados.

Por ejemplo, imagine que se instalan las siguientes aplicaciones COM+:

  • AppX es una aplicación de servidor en PartitionA.
  • AppY es una aplicación de biblioteca en PartitionA.
  • AppZ es una aplicación de servidor en PartitionB.
Si PartitionId especifica PartitionA y se establece GATD_INCLUDE_LIBRARY_APPS:
  • Se incluirá una instancia de AppX.
  • Se incluirá un proceso de cliente que haya creado componentes de AppY.
  • No se incluirá una instancia de AppZ que contenga ningún otro componente COM+ porque AppZ no está en la partición especificada por PartitionId.
  • Sin embargo, si hay otra instancia de AppZ, pero que también ha creado componentes de AppY, este proceso se incluirá aunque la aplicación de servidor no esté en la partición especificada por PartitionId. Este proceso no se incluiría si no se estableció GATD_INCLUDE_LIBRARY_APPS.

Requisitos

   
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comsvcs.h

Consulte también

IGetAppTrackerData