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

  • Статья

Извлекает данные отслеживания для всех приложений COM+ в виде объекта коллекции.

Синтаксис

HRESULT GetTrackerDataAsCollectionObject(
  [out] IUnknown **TopLevelCollection
);

Параметры

[out] TopLevelCollection

При возвращении — интерфейс IUnknown для коллекции данных средства отслеживания.

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

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

Комментарии

Этот метод в первую очередь предназначен для того, чтобы разрешить приложениям, подписающимся на интерфейс событий IComTrackingInfoEvents , добавлять поддержку IGetAppTrackerData с минимальными изменениями в коде. Объект, возвращаемый этим методом, идентичен объекту, отправленном в вызовах метода IComTrackingInfoEvent::OnNewTrackingInfo подписчиков, поэтому код для навигации и анализа этой коллекции можно использовать повторно.

Приложения не должны ожидать, что этот метод будет возвращать обновленные данные отслеживания чаще, чем предлагаемый сервером интервал опроса (см. раздел IGetAppTrackerData::GetSuggestedPollingInterval).

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

Требования

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

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

IGetAppTrackerData