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 |
|
| DLL |
|