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

Статья
08/22/2023

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

Синтаксис

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

Параметры

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] Flags

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

[out, optional] Summary

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

[out, optional] Statistics

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

[out, optional] RecycleInfo

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

[out, optional] AnyComponentsHangMonitored

При возврате указывает, настроены ли какие-либо компоненты в процессе для мониторинга зависания. Этот параметр может принимать значение NULL.

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

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

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

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

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

Требования

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

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

IGetAppTrackerData