Método ControlMetrics da classe Msvm_MetricService
Usado para controlar a coleção de métricas para um elemento ou elementos gerenciados.
Sintaxe
uint32 ControlMetrics(
[in] CIM_ManagedElement REF Subject,
[in] CIM_BaseMetricDefinition REF Definition,
[in] uint16 MetricCollectionEnabled
);
Parâmetros
-
Assunto [in]
-
Uma instância CIM_ManagedElement que identifica os elementos gerenciados para os quais as métricas serão coletadas. Se esse parâmetro for Null, as métricas para todos os elementos gerenciados associados ao parâmetro Definition serão coletadas.
-
Definição [in]
-
Uma instância Msvm_BaseMetricDefinition que especifica quais métricas serão coletadas. Se esse parâmetro for Null, as métricas para todas as definições associadas ao elemento gerenciado identificado pelo parâmetro Subject serão coletadas
-
MetricCollectionEnabled [in]
-
Especifica a operação a ser executada na coleção de métricas. Esse deve ser um dos valores a seguir.
-
Habilitar (2)
-
Habilitar a coleção de métricas.
-
Desabilitar (3)
-
Desabilitar a coleção de métricas.
-
Redefinir (4)
-
Redefinir valores de métricas.
-
DMTF Reservado (..)
-
Fornecedor Reservado (32768..65535)
Valor retornado
Esse método retorna um dos valores a seguir.
-
Sucesso (0)
-
Sem suporte (1)
-
Falha (2)
-
Método Reservado (..)
-
Específico do fornecedor (32768..65535)
Comentários
Esse método falhará nas seguintes instâncias:
- Os parâmetros Subject e Definition são nulos.
- Os parâmetros Subject e Definition não são Null e não há uma instância de Msvm_MetricDefForME que associe as duas instâncias.
- O parâmetro Definition é uma referência a uma instância de Msvm_BaseMetricDefinition que não está associada ao Msvm_MetricService por meio de Msvm_ServiceAffectsElement.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2012 [somente aplicativos da área de trabalho] |
| Namespace |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|