Метод IGetAppTrackerData::GetSuggestedPollingInterval (comsvcs.h)
Извлекает минимальный интервал опроса, предлагаемый сервером отслеживания.
Синтаксис
HRESULT GetSuggestedPollingInterval(
[out] DWORD *PollingIntervalInSeconds
);
Параметры
[out] PollingIntervalInSeconds
Рекомендуемый интервал опроса сервера отслеживания в секундах.
Возвращаемое значение
Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG и S_OK.
Комментарии
Приложения, использующие данные средства отслеживания, обычно должны периодически опрашивать сервер отслеживания, чтобы убедиться, что эти данные актуальны. Например, административному приложению, которое отображает данные отслеживания для пользователя, обычно требуется, чтобы эти данные были максимально приближены к режиму реального времени. Однако слишком частый опрос может снизить общую производительность системы. Кроме того, помните, что приложения COM+, обновляющие данные, не отправляют обновления на сервер отслеживания немедленно, поэтому даже в лучшем случае будет некоторая задержка (обычно всего на несколько секунд).
Частота опроса — это глобальная политика, которую администраторы могут при необходимости скорректировать, чтобы сбалансировать актуальность данных и влияние на производительность определенного набора средств, используемых в системах, которыми они управляют. Значение, возвращаемое в PollingIntervalInSeconds , — это минимальное время, в течение которого приложение должно ожидать получения данных отслеживания, прежде чем выполнять другой вызов для получения этих данных. Любое приложение, которое опрашивает сервер tracker, должно вызвать этот метод и соответствующим образом настроить поведение опроса.
Интервал опроса по умолчанию равен частоте событий отслеживания (три секунды). Это значение можно изменить, записав следующее REG_DWORD значение реестра:
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3TrackingInfoPollingFrequency = минимальный интервал опроса
Требования
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
| Целевая платформа | Windows |
| Header | comsvcs.h |