Compartilhar via


Método RequestStateChange da classe CIM_ConcreteJob

Solicita que o estado do trabalho seja alterado para o valor especificado no parâmetro RequestedState. Invocar o método RequestStateChange várias vezes pode resultar na substituição ou perda de solicitações anteriores.

Se 0 for retornado, a tarefa será concluída com êxito. Qualquer outro código de retorno indica uma condição de erro.

Sintaxe

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parâmetros

RequestedState [in]

O estado a ser solicitado para um trabalho. Os valores possíveis são os seguintes:

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 entrar no estado 'Serviço' enquanto estiver suspenso. (Isso é específico do trabalho.)

Terminar (4)

Interrompe o trabalho de maneira 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)

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 de 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 (Use Of Timeout Parameter Not Supported) deverá ser retornado.

Valor retornado

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

Concluído sem erro (0)

Sem suporte (1)

Erro desconhecido/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 – Transição iniciada (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_ConcreteJob