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