Método RequestStateChange da classe CIM_EnabledLogicalElement

Artigo
06/13/2023

Solicita que o estado do elemento seja alterado para o valor especificado no parâmetro RequestedState. Quando a alteração de estado solicitada ocorrer, EnabledState e RequestedState do elemento serão os mesmos. Invocar o método RequestStateChange várias vezes pode resultar na substituição ou perda de solicitações anteriores.

Sintaxe

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

Parâmetros

RequestedState [in]: O estado solicitado para o elemento . Essas informações serão colocadas na propriedade RequestedState da instância se o código de retorno do método RequestStateChange for 0 ('Concluído sem Erro') ou 4096 (0x1000) ('Trabalho Iniciado'). Consulte a descrição das propriedades EnabledState e RequestedState para obter as explicações detalhadas dos valores RequestedState .
Iniciar (2): Altera o estado para "Em execução".
Suspender (3): Interrompe o trabalho temporariamente. A intenção é reiniciar o trabalho posteriormente com 'Iniciar'. Talvez seja possível inserir o estado "Serviço" enquanto estiver suspenso. (Isso é específico do trabalho.)
Encerrar (4): Interrompe o trabalho de forma limpa, salva dados, preserva o estado e desliga todos os processos subjacentes de maneira ordenada.
Kill (5): Encerra o trabalho imediatamente sem nenhum requisito para salvar dados ou preservar o estado.
Serviço (6): Coloca o trabalho em um estado de serviço específico do fornecedor. Talvez seja possível reiniciar o trabalho.
DMTF Reservado (7..32767)
Fornecedor Reservado (32768..65535)

Trabalho [out]

Pode conter uma referência à CIM_ConcreteJob criada para acompanhar a transição de estado iniciada pela invocação do método.

TimeoutPeriod [in]

Um período de tempo limite que especifica a quantidade máxima de tempo que o cliente espera que a transição para o novo estado leve. O formato de intervalo deve ser usado para especificar o período de tempo limite. Um valor igual a 0 ou Null indica que o cliente não tem requisitos de tempo para a transição. Se essa propriedade não contiver 0 ou Null e a implementação não der suporte a esse parâmetro, um código de retorno de 4098 (Parâmetro de Uso de Tempo limite sem suporte) deverá ser retornado.

Valor retornado

Retorna um 0 com êxito; caso contrário, retornará um erro.

Concluído sem erro (0)
Sem suporte (1)
Erro desconhecido ou não especificado (2)
Não é possível concluir dentro do período de tempo limite (3)
Falha (4)
Parâmetro inválido (5)
Em Uso (6)
DMTF Reservado (..)
Parâmetros de método verificados – Trabalho iniciado (4096)
Transição de estado inválida (4097)
Uso do parâmetro timeout sem suporte (4098)
Ocupado (4099)
Método Reservado (4100..32767)
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

CIM_EnabledLogicalElement

Compartilhar via