Compartilhar via


Método RequestStateChange da classe MSFT_StorageJob

Solicita que o estado do trabalho seja alterado para o valor especificado no parâmetro RequestedState .

Sintaxe

UInt32 RequestStateChange(
  [in]  UInt16 RequestedState,
  [out] String ExtendedStatus
);

Parâmetros

RequestedState [in]

O novo estado.

Valor Significado
Iniciar 2 Esse valor altera o valor da propriedade JobState para Running.
Suspender 3 Esse valor interrompe o trabalho temporariamente. A intenção é reiniciar o trabalho posteriormente com uma segunda chamada para RequestStateChange com o parâmetro RequestedState definido como Start. Pode ser possível que o trabalho insira o estado de Serviço enquanto ele está suspenso. (Isso é específico do trabalho.)
Terminar 4 Esse valor interrompe o trabalho de forma limpa, salvando dados, preservando o estado e desligando todos os processos subjacentes de maneira ordenada.
Matar 5 Esse valor encerra o trabalho imediatamente sem nenhum requisito para salvar dados ou preservar o estado.
Serviço 6 Esse valor coloca o trabalho em um estado de serviço específico do fornecedor. Talvez seja possível reiniciar o trabalho.
DMTF Reservado 7..32767 Os valores entre 7 e 32767 (inclusive) são reservados para DMTF.
Fornecedor Reservado 32768..65535 Os valores entre 32768 e 65535 (inclusive) são reservados para fornecedores.

ExtendedStatus [out]

Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.

Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).

Retornar valor

Sucesso (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Falha (4)

Parâmetro inválido (5)

Parâmetros de método verificados – Trabalho iniciado (4096)

Tamanho sem suporte (4097)

Acesso negado (40001)

Não há recursos suficientes para concluir a operação. (40002)

Não é possível se conectar ao provedor de armazenamento. (46000)

O provedor de armazenamento não pode se conectar ao subsistema de armazenamento. (46001)

Comentários

Se você chamar esse método várias vezes, as solicitações anteriores poderão ser substituídas ou perdidas.

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\Microsoft\Windows\Storage
MOF Storagewmi.mof

Confira também

MSFT_StorageJob