Метод ControlSampleTimes класса CIM_MetricService
Позволяет начать сбор метрик на определенный момент времени и указать предпочтительный интервал выборки для периодического сбора данных.
При каждом запуске выборки для дополнительных метрик можно использовать параметры, заданные этим методом.
Синтаксис
uint32 ControlSampleTimes(
[in] datetime StartSampleTime,
[in] datetime PreferredSampleInterval,
[in] boolean RestartGathering
);
Параметры
-
StartSampleTime [in]
-
Момент времени начала выборки для метрик.
Значение 99990101000000.00000+000 должно указывать, что выборка должна начинаться при следующей синхронизации с полным часом. Выборка синхронизируется с полным часом, если с момента полуночи интервал выборки по модулю в секундах равен 0.
-
PreferredSampleInterval [in]
-
Предпочтительное время интервала выборки. Чтобы получить коррелируемые метрики, рекомендуется выбрать интервал выборки таким образом, чтобы интервал выборки 3600 по модулю в секундах был равен 0.
Решение о том, соблюдается ли запрошенный интервал выборки, отвечает реализация службы метрик CIM.
Клиент CIM может проверка, соблюдают ли поставщики метрик запрошенное время интервала выборки, извлекая связанные экземпляры BaseMetricDefinition и проверяя содержимое CIM_BaseMetricDefinition. Свойство SampleInterval.
-
RestartGathering [in]
-
Значение TRUE для запроса на повторный запуск сбора всех метрик, связанных со службой метрик, с помощью этого вызова метода.
Возвращаемое значение
Возвращает значение 0 при успешном выполнении; в противном случае возвращает ошибку.
-
Успешно (0)
-
Не поддерживается (1)
-
Сбой (2)
-
Зарезервированный метод (..)
-
Конкретный поставщик (32768..65535)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 8.1 |
| Минимальная версия сервера |
Windows Server 2012 R2 |
| Пространство имен |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|