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

Recupera información de resumen de todos los componentes COM+ hospedados en un único proceso o para un subconjunto especificado de estos componentes.

Sintaxis

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

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 el parámetro 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] 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_LIBRARY_APPS, GATD_INCLUDE_SWC, GATD_INCLUDE_CLASS_NAME, GATD_INCLUDE_APPLICATION_NAME. Consulte los comentarios siguientes para obtener más información.

[out] NumComponentsInProcess

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

[out] Components

A cambio, una matriz de estructuras ComponentSummary para los componentes 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 Components .
S_FALSE	El método se completó correctamente, pero no había componentes que coincidan con los criterios de filtro.
COMADMIN_E_APP_NOT_RUNNING	El proceso especificado no existe o no hospeda ninguna aplicación COM+ de seguimiento.

Comentarios

Un proceso se puede seleccionar mediante su identificador de instancia de aplicación o su identificador de proceso, pero no ambos. La selección por identificador de instancia de aplicación suele ser preferible, 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 se incluyen en los resultados los componentes de la aplicación de servidor COM+. Si se establece GATD_INCLUDE_LIBRARY_APPS, también se incluyen los componentes de las aplicaciones de biblioteca COM+ en el proceso, si los hay. Si se establece GATD_INCLUDE_SWC, los resultados también incluirán entradas para los contextos De servicios sin componentes.

Si ApplicationId se usa para especificar una aplicación (no está establecida en GUID_NULL), las marcas GATD_INCLUDE_LIBRARY_APPS y GATD_INCLUDE_SWC no son significativas y no son válidas para usarlas. Se devolverán los componentes de la aplicación especificada, independientemente del tipo de esa aplicación.

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