Método RequestStateChange da classe MSFT_NetNeighbor
Solicita que o estado do elemento seja alterado para o valor especificado no parâmetro RequestedState. Quando a alteração de estado solicitada ocorrer, o EnabledState e RequestedState do elemento serão os mesmos. Invocar o método RequestChangeState várias vezes pode resultar na substituição ou perda de solicitações anteriores. Se 0 for retornado, a tarefa será concluída com êxito e o uso de ConcreteJob não será necessário. Se 4096 (0x1000) for retornado, a tarefa levará algum tempo para ser concluída, ConcreteJob será criada 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
-
requestedState [in]
-
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 ('Completed with No Error'), 3 ('Timeout') ou 4096 (0x1000) ('Trabalho Iniciado'). Consulte a descrição das propriedades EnabledState e RequestedState para obter as explicações detalhadas dos valores RequestedState.
-
Habilitado (2)
-
desabilitado (3)
-
desligar (4)
-
offline (6)
-
de teste (7)
-
Adiar (8)
-
Quiesce (9)
-
reinicialização (10)
-
Redefinir (11)
-
Reservado DMTF (12 32767)
-
Reservadas do Fornecedor (32768 65535)
-
-
job [out]
-
Um CIM_ConcreteJob que contém uma referência ao trabalho (pode ser nulo se a tarefa for concluída).
-
TimeoutPeriod [in]
-
Um período de tempo limite que especifica o tempo máximo 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 nulo indica que o cliente não tem requisitos de tempo para a transição. Se essa propriedade não contiver 0 ou nulo e a implementação não oferecer suporte a esse parâmetro, um código de retorno de "Uso do Parâmetro de Tempo limite sem suporte" deverá ser retornado.
Valor de retorno
-
concluído sem erro (0)
-
sem suporte (1)
-
de erro desconhecido ou não especificado (2)
-
Não é possível concluir dentro do período de tempo limite (3)
-
com falha (4)
-
de parâmetro inválido (5)
-
em uso (6)
-
Reservado DMTF (7 4095)
-
Parâmetros do método verificados – trabalho iniciado (4096)
-
de Transição de Estado Inválida (4097)
-
uso do parâmetro timeout sem suporte (4098)
-
Ocupado (4099)
-
método reservado (4100 32767)
-
específicas do fornecedor (32768 65535)
Requisitos
| Cliente mínimo com suporte |
Windows 8 |
| Servidor mínimo com suporte |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|