Метод IGetAppTrackerData::GetComponentDetails (comsvcs.h)

Статья
08/22/2023

Извлекает подробные сведения об одном компоненте COM+, размещенном в процессе.

Синтаксис

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

Параметры

[in] ApplicationInstanceId

GUID экземпляра приложения, который однозначно идентифицирует отслеживаемый процесс для выбора, или GUID_NULL, если вместо этого будет использоваться параметр ProcessId .

[in] ProcessId

Идентификатор процесса, определяющий процесс для выбора, или 0, если для выбора будет использоваться ApplicationInstanceId .

[in] Clsid

Идентификатор CLSID компонента.

[in] Flags

Сочетание флагов из перечисления GetAppTrackerDataFlags для выбора возвращаемых данных. Поддерживаются следующие флаги: GATD_INCLUDE_CLASS_NAME (при получении сводки) GATD_INCLUDE_APPLICATION_NAME (при получении сводки).

[out] Summary

При возврате структура ComponentSummary с сводной информацией о компоненте. Этот параметр может принимать значение NULL.

[out] Statistics

При возврате структура ComponentStatistics со статистикой для компонента. Этот параметр может принимать значение NULL.

[out] HangMonitorInfo

При возврате структура ComponentHangMonitorInfo с конфигурацией мониторинга зависания для компонента. Этот параметр может принимать значение NULL.

Возвращаемое значение

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG и E_OUTOFMEMORY, а также следующие значения.

Код возврата	Описание
S_OK	Метод завершился успешно.
COMADMIN_E_APP_NOT_RUNNING	Указанный процесс не существует или не содержит отслеживаемых приложений COM+.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	Указанный компонент не существует в указанном процессе.

Процесс может быть выбран по идентификатору экземпляра приложения или идентификатору процесса, но не по обоим. Выбор по идентификатору экземпляра приложения обычно предпочтителен, так как идентификаторы процессов могут использоваться повторно после завершения процесса. Однако выбор по идентификатору процесса может оказаться полезным, если вы получили идентификатор процесса из другого источника, например из аргумента командной строки для программы.

Вы можете запросить любую или всю информацию, доступную для компонента, передав значения, отличные от NULL , для сводки, статистики или HangMonitorInfo. По крайней мере один из этих параметров не должен иметь значение NULL.

Требования


Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	comsvcs.h

См. также раздел

IGetAppTrackerData