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

Recupera información de resumen para todas las aplicaciones COM+ hospedadas en un único proceso o para un subconjunto especificado de estas aplicaciones.

Sintaxis

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

Parámetros

[in] ApplicationInstanceId

Guid de instancia de aplicación que identifica de forma única el proceso de seguimiento que se va a seleccionar o GUID_NULL si el parámetro ProcessId se usará para la selección en su lugar.

[in] ProcessId

Identificador de proceso que identifica el proceso que se va a seleccionar o 0 si ApplicationInstanceId se usará para la selección en su lugar.

[in] PartitionId

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

[in] Flags

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

[out] NumApplicationsInProcess

Al devolver, el número de aplicaciones del proceso que coinciden con los criterios de filtro especificados por PartitionId y Flags.

[out] Applications

A cambio, una matriz de estructuras ApplicationSummary para las aplicaciones coincidentes.

Valor devuelto

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

Código devuelto	Descripción
S_OK	El método se completó correctamente y los resultados se encuentran en el parámetro Applications .
S_FALSE	El método se completó correctamente, pero no había procesos que coincidan con los criterios de filtro.
COMADMIN_E_APP_NOT_RUNNING	El proceso especificado no existe o no hospeda ninguna aplicación COM+ con seguimiento.

Comentarios

Un proceso se puede seleccionar mediante su identificador de instancia de aplicación o su identificador de proceso, pero no ambos. Por lo general, se prefiere la selección por identificador de instancia de aplicación, ya que los identificadores de proceso se pueden reutilizar después de que finalice un proceso. Sin embargo, la selección por identificador de proceso puede ser útil si obtiene el identificador de proceso de algún otro origen, como un argumento de línea de comandos para el programa.

Si ni GATD_INCLUDE_LIBRARY_APPS ni GATD_INCLUDE_SWC se establecen en Marcas, solo la aplicación de servidor COM+ se incluye en los resultados. Si se establece GATD_INCLUDE_LIBRARY_APPS, también se incluyen las aplicaciones de biblioteca COM+ en el proceso, si las hay. Si se establece GATD_INCLUDE_SWC y el proceso hospeda uno o varios contextos de Servicios sin componentes, los resultados también incluirán una única entrada pseudoaplicación con un resumen de los contextos de SWC.

Requisitos

Requisito	Value
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