Método RequestStateChange da classe Msvm_MigrationJob

  • Artigo

Solicita que o estado do trabalho de migração 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]

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

Terminar (4)

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

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

acima (0)

(32768)

(32769)

(32770)

(32771)

(32772)

(32773)

(32774)

(32775)

(32776)

(32777)

(32778)

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_MigrationJob