Compartir a través de


Método ControlSampleTimes de la clase CIM_MetricService

Permite que se inicie la especificación de la recopilación de métricas a un momento dado y especifique el tiempo de intervalo de muestra preferido para la recopilación periódica de datos.

Cada vez que se inicia el muestreo de métricas adicionales, se puede usar la configuración especificada por este método.

Sintaxis

uint32 ControlSampleTimes(
  [in] datetime StartSampleTime,
  [in] datetime PreferredSampleInterval,
  [in] boolean  RestartGathering
);

Parámetros

StartSampleTime [in]

Momento dado en el que se va a iniciar el muestreo de las métricas.

Un valor de 99990101000000.0000000+000 indicará que el muestreo debe comenzar a la próxima vez que se sincronice con la hora completa. El muestreo se sincroniza con la hora completa si los segundos desde el intervalo de muestra de módulo de medianoche en segundos es igual a 0.

PreferredSampleInterval [in]

Tiempo de intervalo de ejemplo preferido. Para obtener métricas correlables, se recomienda elegir el intervalo de muestra de una manera que el tiempo de intervalo de muestra de 3600 módulos en segundos sea igual a 0.

Es responsabilidad de la implementación del servicio de métricas CIM decidir si se respeta el tiempo de intervalo de muestra solicitado.

El cliente CIM puede comprobar si los proveedores de métricas respetan o no el tiempo de intervalo de ejemplo solicitado recuperando instancias de BaseMetricDefinition relacionadas y comprobando el contenido del CIM_BaseMetricDefinition. Propiedad SampleInterval .

RestartGathering [in]

TRUE para solicitar que la recopilación de todas las métricas asociadas al servicio de métricas se vuelva a iniciar con esta llamada de método.

Valor devuelto

Devuelve un 0 si se ejecuta correctamente; de lo contrario, devuelve un error.

Correcto (0)

No compatible (1)

Error (2)

Método Reservado (..)

Específico del proveedor (32768..65535)

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 8.1
Servidor mínimo compatible
Windows Server 2012 R2
Espacio de nombres
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
Archivo DLL
Vmms.exe

Consulte también

CIM_MetricService