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 do fornecedor. Invocar esse método várias vezes pode fazer com que solicitações anteriores sejam substituídas ou perdidas.

Sintaxe

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

Parâmetros

Estado Solicitado [em]

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

Valores	Significado
Iniciar 2	Altera o estado para Em execução.
Suspend 3	Interrompe o trabalho temporariamente. Você pode reiniciar o trabalho e, possivelmente, entrar no estado 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 encerra todos os processos subjacentes de maneira ordenada.
Matar 5	Interrompe o trabalho imediatamente sem a necessidade de 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 a partir desse estado.
DMTF Reservado 7 32767	Reservado.
Fornecedor Reservado 32768 65535	Reservado.

TimeoutPeriod [em]

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 parâmetro TimeoutPeriod . Um valor de 0 ou um parâmetro null indica que o cliente não tem requisitos de tempo para a transição.

Observação

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

Valor retornado

Esse método retorna um dos seguintes valores.

Concluído com nenhum erro (0)

Sem suporte (1)

Erro desconhecido/não especificado (2)

NÃO pode concluir dentro do Período de Tempo Limite (3)

Falhou (4)

Parâmetro inválido (5)

Em uso (6)

DMTF Reservado (7 4095)

Parâmetros do método verificados - transição iniciada (4096)

Transição de estado inválida (4097)

Uso do parâmetro Timeout não suportado (4098)

Ocupado (4099)

Método Reservado (4100 32767)

Fornecedor Específico (32768 65535)

Requisitos

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

Confira também

CIM_ConcreteJob