Método RequestStateChange da classe WMI CIM_ConcreteJob

Solicita que o estado do trabalho seja alterado para o valor especificado. As transições permitidas são específicas do trabalho e específicas do fornecedor. Invocar esse método várias vezes pode fazer com que as solicitações anteriores sejam substituídas ou perdidas.

Sintaxe

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parâmetros

requestedState [in]

Especifica o estado para o qual o trabalho deve ser alterado.

Valores	Significado
iniciar 2	Altera o estado para Em execução.
suspender 3	Interrompe o trabalho temporariamente. Você pode reiniciar o trabalho e, possivelmente, entrar no estado de Serviço enquanto o trabalho está suspenso. Esse valor é específico do trabalho.
encerrar 4	Interrompe o trabalho de forma limpa, salva dados, preserva o estado e desliga todos os processos subjacentes de maneira ordenada.
Kill 5	Interrompe o trabalho imediatamente sem nenhum requisito para salvar dados ou preservar o estado.
do Serviço 6	Coloca o trabalho em um estado de serviço específico do fornecedor. Talvez seja possível reiniciar o trabalho desse estado.
reservada DMTF 7 32767	Reservado.
reservadas do fornecedor 32768 65535	Reservado.

TimeoutPeriod [in]

Especifica o tempo máximo que o cliente espera que a transição para o novo estado leve. O formato de intervalo deve ser usado para especificar o parâmetro TimeoutPeriod. Um valor de 0 ou um parâmetro nulo indica que o cliente não tem requisitos de tempo para a transição.

Nota

Se a implementação não der suporte a esse parâmetro e essa propriedade não contiver 0 ou nulo, o valor Use Of Timeout Parameter Not Supported value deverá ser retornado.

Valor de retorno

Esse método retorna um dos valores a seguir.

concluído sem erro (0)

sem suporte (1)

de erro desconhecido/não especificado (2)

NÃO é possível concluir dentro do período de tempo limite (3)

com falha (4)

de parâmetro inválido (5)

em uso (6)

Reservado DMTF (7 4095)

Parâmetros do método verificados – iniciados pela transição (4096)

de Transição de Estado Inválida (4097)

uso do parâmetro timeout sem suporte (4098)

Ocupado (4099)

método reservado (4100 32767)

específicas do fornecedor (32768 65535)

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Namespace	Root\standardcimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

Consulte também

CIM_ConcreteJob