Método RequestStateChange da classe Msvm_ConcreteJob

Solicita que o estado do trabalho seja alterado para o estado especificado. 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]

Tipo: uint16

O novo estado de um trabalho.

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, salvando dados, preservando o estado e desligando 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

Reservado.

Fornecedor Reservado

Reservado.

TimeoutPeriod [in]

Tipo: datetime

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

Tipo: uint32

Esse método retorna um dos valores a seguir.

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 (7 4095)

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)

Comentários

O acesso à classe Msvm_ConcreteJob pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de Conta de Usuário e WMI.

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	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

Msvm_ConcreteJob