Метод 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 |