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

Статья
08/22/2023

Извлекает сводные сведения для всех приложений COM+, размещенных в одном процессе, или для указанного подмножества этих приложений.

Синтаксис

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

Параметры

[in] ApplicationInstanceId

ИДЕНТИФИКАТОР GUID экземпляра приложения, который однозначно определяет отслеживаемый процесс для выбора, или GUID_NULL, если для выбора будет использоваться параметр ProcessId .

[in] ProcessId

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

[in] PartitionId

Идентификатор секции для фильтрации результатов или GUID_NULL для всех секций.

[in] Flags

Сочетание флагов из перечисления GetAppTrackerDataFlags для фильтрации результатов и выбора возвращаемых данных. Поддерживаются следующие флаги: GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC GATD_INCLUDE_APPLICATION_NAME. Подробнее см. ниже в разделе Примечания.

[out] NumApplicationsInProcess

При возврате — количество приложений в процессе, соответствующих критериям фильтра, заданным partitionId и Flags.

[out] Applications

При возврате — массив структур ApplicationSummary для соответствующих приложений.

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

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

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

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

Если ни GATD_INCLUDE_LIBRARY_APPS, ни GATD_INCLUDE_SWC не заданы в разделе Флаги, в результаты включается только серверное приложение COM+. Если задано GATD_INCLUDE_LIBRARY_APPS, в процесс также включаются приложения библиотеки COM+, если таковые имеются. Если задано GATD_INCLUDE_SWC и в процессе размещается один или несколько контекстов служб без компонентов, результаты также будут включать одну запись псевдо-приложения с сводкой контекстов SWC.

Требования

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

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

IGetAppTrackerData