classe MSFT_StorageJob
Representa um trabalho de armazenamento.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format).
Os trabalhos de armazenamento representam operações de execução prolongada em um subsistema de armazenamento. Essas operações podem ser iniciadas de qualquer uma das seguintes maneiras:
- Pelos usuários, por meio das várias interfaces de gerenciamento definidas por esse MOF.
- Automaticamente, por subsistemas de armazenamento inteligente.
Sintaxe
class MSFT_StorageJob : MSFT_StorageObject
{
String Name;
String Description;
Datetime ElapsedTime;
UInt16 ErrorCode;
String ErrorDescription;
UInt16 JobState;
String JobStatus;
UInt16 LocalOrUtcTime;
UInt16 OperationalStatus[];
String StatusDescriptions[];
UInt16 PercentComplete;
Datetime StartTime;
Datetime TimeBeforeRemoval;
Datetime TimeOfLastStateChange;
Datetime TimeSubmitted;
Boolean DeleteOnCompletion;
Boolean IsBackgroundTask;
UInt16 RecoveryAction;
String OtherRecoveryAction;
};
Membros
A classe MSFT_StorageJob tem estes tipos de membros:
Métodos
A classe MSFT_StorageJob tem esses métodos.
| Método | Descrição |
|---|---|
| GetExtendedStatus | Recupera informações de status estendidas para um trabalho de armazenamento malsucedido. |
| RequestStateChange | Solicita que o estado do trabalho seja alterado para o valor especificado no parâmetro RequestedState . |
Propriedades
A classe MSFT_StorageJob tem essas propriedades.
DeleteOnCompletion
Tipo de dados: booliano
Tipo de acesso: Somente leitura
Se TRUE, o trabalho de armazenamento será excluído automaticamente após um curto intervalo de tempo.
Descrição
Tipo de dados: Cadeia de caracteres
Tipo de acesso: Somente leitura
Uma descrição textual da operação que o trabalho de armazenamento está acompanhando.
ElapsedTime
Tipo de dados: Datetime
Tipo de acesso: Somente leitura
Se o trabalho ainda estiver em execução, essa propriedade indicará há quanto tempo está em execução. Se o trabalho for concluído, será o tempo total de execução.
ErrorCode
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Se a operação que esse trabalho de armazenamento estava acompanhando falhou, o provedor definirá essa propriedade como um código de erro definido pelo método que invocou a operação. Se esse trabalho de armazenamento estiver acompanhando uma tarefa em segundo plano, o código de erro poderá ser definido como qualquer código de erro de gerenciamento de armazenamento válido, conforme definido no mapa de valores abaixo. Se não houver erro, essa propriedade deverá ser definida como Êxito. Essa propriedade deve ser NULL até que a operação seja concluída.
ErrorDescription
Tipo de dados: Cadeia de caracteres
Tipo de acesso: Somente leitura
Uma cadeia de caracteres de forma livre que contém a descrição do erro do fornecedor.
IsBackgroundTask
Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
Se TRUE, esse trabalho de armazenamento representará uma tarefa automatizada em segundo plano iniciada pelo subsistema de armazenamento. Para todas as operações iniciadas pelo usuário ou pelo gerenciamento, esse valor deve ser definido como FALSE.
JobState
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
O estado do trabalho.
Novo (2)
Começando (3)
Em execução (4)
Suspenso (5)
Desligar (6)
Concluído (7)
Encerrado (8)
Morto (9)
Exceção (10)
Serviço (11)
Consulta pendente (12)
Microsoft Reserved (13..32767)
Fornecedor Reservado (32768..65535)
Jobstatus
Tipo de dados: Cadeia de caracteres
Tipo de acesso: Somente leitura
Uma cadeia de caracteres de forma livre que representa o status do trabalho. O status primário é refletido na propriedade OperationalStatus. JobStatus fornece detalhes adicionais e específicos da implementação.
LocalOrUtcTime
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Valores ( "Hora Local", "Hora UTC" ), ValueMap ("1", "2")
Indica se os valores de hora nas propriedades RunStartInterval e UntilTime representam a hora local ou a hora UTC. Os valores de hora são sincronizados em todo o mundo definindo essa propriedade como Hora UTC.
Nome
Tipo de dados: Cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
Um nome definido pelo sistema para o trabalho de armazenamento.
OperationalStatus
Tipo de dados: matriz UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
Indica o status atual de cada subsistema de armazenamento que está participando do trabalho de armazenamento.
| Valor | Significado |
|---|---|
| Desconhecido 0 | O status operacional é desconhecido. |
| Outros 1 | Um OperationalStatus específico do fornecedor é especificado na propriedade OtherOperationalStatusDescription . |
| OK 2 | O subsistema de armazenamento está respondendo aos comandos e está em um estado operacional normal. |
| Degradado 3 | O subsistema de armazenamento está respondendo aos comandos, mas não está em execução em um estado operacional ideal. |
| Estressado 4 | O subsistema de armazenamento está funcionando, mas precisa de atenção. Por exemplo, ele pode estar sobrecarregado ou superaquecido. |
| Falha preditiva 5 | O subsistema de armazenamento está funcionando, mas é provável que falhe em um futuro próximo. |
| Erro 6 | Ocorreu um erro. |
| Erro não recuperável 7 | Ocorreu um erro não recuperável. |
| A partir de 8 | O subsistema de armazenamento está em processo de inicialização. |
| Parando 9 | O subsistema de armazenamento está em processo de interrupção. |
| Parado 10 | O subsistema de armazenamento foi interrompido ou desligado de forma limpo e ordenada. |
| No Serviço 11 | O subsistema de armazenamento está sendo configurado, mantido, limpo ou administrado de outra forma. |
| Sem Contato 12 | O provedor de armazenamento está ciente do subsistema de armazenamento, mas nunca foi capaz de se comunicar com ele. |
| Comunicação Perdida 13 | O provedor de armazenamento está ciente do subsistema de armazenamento e se comunicou com ele no passado, mas atualmente não consegue se comunicar com ele. |
| Abortado 14 | O subsistema de armazenamento foi interrompido abruptamente e pode exigir configuração ou manutenção. |
| Dormente 15 | O provedor de armazenamento pode entrar em contato com o subsistema de armazenamento, mas o subsistema de armazenamento não está ativo no momento. |
| Entidade de suporte no erro 16 | Esse valor indica que outro dispositivo ou conexão da qual o subsistema de armazenamento depende pode precisar de atenção. Ele não indica necessariamente problemas com o próprio subsistema de armazenamento. |
| Concluído 17 | O subsistema de armazenamento concluiu uma operação. Esse valor deve ser combinado com "OK", "Erro" ou "Degradado", dependendo do resultado da operação. |
| Modo de Energia 18 | Esse valor é reservado para uso do sistema. |
| DMTF Reservado .. | Valores entre 18 e 0x8000 (exclusivo) são reservados para DMTF. |
| 0x8000 Reservadas do Fornecedor .. | Valores maiores ou iguais a 0x8000 são reservados para fornecedores. |
OtherRecoveryAction
Tipo de dados: Cadeia de caracteres
Tipo de acesso: Somente leitura
Uma ação de recuperação específica do fornecedor a ser executada para um trabalho executado sem êxito. Essa propriedade só deverá ser definida se RecoveryAction estiver definido como Outros.
PercentComplete
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório, Unidades (Porcentagem)
O percentual do trabalho concluído no momento em que esse valor é solicitado.
RecoveryAction
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Descreve a ação de recuperação a ser executada para um trabalho executado sem êxito. Um dos valores a seguir.
| Valor | Significado |
|---|---|
| Desconhecido 0 | A ação de recuperação desejada é desconhecida. |
| Outros 1 | A ação de recuperação é especificada na propriedade OtherRecoveryAction . |
| Não Continuar 2 | Pare de executar o trabalho de armazenamento e atualize adequadamente seu status. |
| Continuar com o próximo trabalho 3 | Continue com o próximo trabalho na fila. |
| Executar novamente o Trabalho 4 | Execute novamente o trabalho. |
StartTime
Tipo de dados: Datetime
Tipo de acesso: Somente leitura
A hora em que o trabalho foi iniciado.
StatusDescriptions
Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura
Descrições dos valores OperationalStatus . Por exemplo, se Stop for um valor em OperationalStatus, o elemento de matriz correspondente de StatusDescriptions poderá explicar por que um objeto está sendo interrompido.
TimeBeforeRemoval
Tipo de dados: Datetime
Tipo de acesso: Somente leitura
A quantidade de tempo, em segundos, que o trabalho é mantido após a conclusão da execução, seja com êxito ou falha nessa execução. O trabalho deve permanecer existente por algum período de tempo, independentemente do valor da propriedade DeleteOnCompletion .
TimeOfLastStateChange
Tipo de dados: Datetime
Tipo de acesso: Somente leitura
A hora em que o estado do trabalho foi alterado pela última vez. Se o estado do trabalho não tiver sido alterado e essa propriedade não tiver um valor, ela deverá ser definida como zero. Se uma alteração de estado foi solicitada, mas foi rejeitada ou ainda não foi processada, o valor dessa propriedade não deve ser atualizado.
TimeSubmitted
Tipo de dados: Datetime
Tipo de acesso: Somente leitura
A hora em que o trabalho foi enviado para execução. Um valor de todos os zeros indica que o elemento proprietário não é capaz de relatar uma data e hora. Portanto, ScheduledStartTime e StartTime são relatados como intervalos relativos à hora em que seus valores são solicitados.
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 |