Método RequestStateChange da classe Msvm_MigrationJob
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 |
|
| DLL |
|