Compartilhar via


Método RequestStateChange da classe CIM_LANEndpoint

Solicita que o estado do elemento seja alterado para o valor especificado no parâmetro RequestedState . Quando a alteração de estado solicitada ocorrer, EnabledState e RequestedState do elemento serão os mesmos. Invocar o método RequestChangeState várias vezes pode resultar em solicitações anteriores sendo substituídas ou perdidas. Se 0 for retornado, a tarefa foi concluída com êxito e o uso de ConcreteJob não foi necessário. Se 4096 (0x1000) for retornado, a tarefa levará algum tempo para ser concluída, ConcreteJob será criado e sua referência retornada no parâmetro de saída Job. Qualquer outro código de retorno indica uma condição de erro.

Sintaxe

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

Parâmetros

Estado Solicitado [em]

O estado solicitado para o elemento. Essas informações serão colocadas na propriedade RequestedState da instância se o código de retorno do método RequestStateChange for 0 ('Concluído sem erro'), 3 ('Timeout') ou 4096 (0x1000) ('Trabalho iniciado'). Consulte a descrição das propriedades EnabledState e RequestedState para obter explicações detalhadas dos valores RequestedState .

Habilitado (2)

Desabilitado (3)

Desligar (4)

Offline (6)

Teste (7)

Diferimento (8)

Quiesce (9)

Reinicialização (10)

Redefinir (11)

DMTF Reservado (12 32767)

Fornecedor Reservado (32768 65535)

Emprego [out]

Um CIM_ConcreteJob que contém uma referência ao trabalho (pode ser nulo se a tarefa for concluída).

TimeoutPeriod [em]

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 esse período. Um valor de 0 ou um parâmetro 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 oferecer suporte a esse parâmetro, um código de retorno de 'Use Of Timeout Parameter Not Supported' deverá ser retornado.

Valor retornado

Concluído com nenhum erro (0)

Sem suporte (1)

Erro desconhecido ou não especificado (2)

Não é possível 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 - Trabalho iniciado (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

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_LANEndpoint