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

  • Artículo

Recupera información detallada sobre un único componente COM+ hospedado en un proceso.

Sintaxis

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

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

CLSID del componente.

[in] Flags

Combinación de marcas de la enumeración GetAppTrackerDataFlags para seleccionar qué datos se devuelven. Se admiten las marcas siguientes: GATD_INCLUDE_CLASS_NAME (si se recupera un resumen), GATD_INCLUDE_APPLICATION_NAME (si se recupera un resumen).

[out] Summary

A cambio, una estructura ComponentSummary con información de resumen para el componente. Este parámetro puede ser NULL.

[out] Statistics

A cambio, una estructura ComponentStatistics con estadísticas para el componente. Este parámetro puede ser NULL.

[out] HangMonitorInfo

A cambio, una estructura ComponentHangMonitorInfo con configuración de supervisión de bloqueo para el componente. Este parámetro puede ser NULL.

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.
COMADMIN_E_APP_NOT_RUNNING
 El proceso especificado no existe o no hospeda ninguna aplicación COM+ de seguimiento.
COMADMIN_E_OBJECT_DOES_NOT_EXIST
 El componente especificado no existe en el proceso especificado.

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.

Puede solicitar cualquier o toda la información disponible para el componente pasando valores que no sean NULL para Summary, Statistics o HangMonitorInfo. Al menos uno de estos parámetros debe ser distinto de NULL.

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