Compartilhar via


Método RequestStateChange da classe Msvm_StorageJob

Solicita uma alteração de estado.

Sintaxe

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

Parâmetros

RequestedState [in]

RequestStateChange altera o estado de 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 inserir o estado "Serviço" enquanto estiver suspenso. (Isso é 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)

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

Esse método retorna um dos seguintes valores:

acima (0)

(32768)

(32769)

(32770)

(32771)

(32772)

(32773)

(32774)

(32775)

(32776)

(32777)

(32778)

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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Confira também

Msvm_StorageJob