Compartilhar via


Método ControlSampleTimes da classe Msvm_MetricService

Define os tempos de exemplo de controle.

Sintaxe

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

Parâmetros

StartSampleTime [in]

Ponto no tempo em que a amostragem para as métricas deve ser iniciada.

Um valor de 99990101000000.000000+000 deve indicar que a amostragem deve começar na próxima vez que for sincronizada com a hora inteira. A amostragem será sincronizada com a hora inteira se os segundos desde o intervalo de amostra do módulo da meia-noite em segundos forem iguais a 0.

PreferredSampleInterval [in]

Tempo de intervalo de exemplo preferencial. Para obter métricas correlacionadas, é recomendável que o intervalo de exemplo seja escolhido de uma forma que o tempo de intervalo de amostra de módulo 3600 em segundos seja igual a 0.

É responsabilidade da implementação do serviço de métrica CIM decidir se o tempo de intervalo de amostra solicitado é respeitado.

O cliente CIM pode marcar se os provedores de métricas estão ou não respeitando o tempo de intervalo de exemplo solicitado recuperando instâncias BaseMetricDefinition relacionadas e verificando o conteúdo da propriedade "CIM_BaseMetricDefinition.SampleInterval".

RestartGathering [in]

Booliano que, quando definido como TRUE, solicita que a coleta de todas as métricas associadas ao serviço de métrica seja iniciada novamente com essa chamada de método.

Valor retornado

Esse método retorna um dos seguintes valores:

Êxito (0)

Sem suporte (1)

Falha (2)

Método Reservado (..)

Específico do fornecedor (32768..65535)

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8.1
Servidor mínimo com suporte
Windows Server 2012 R2
Namespace
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Confira também

Msvm_MetricService