Método OnlineDevice da classe CIM_LogicalPort
O método OnlineDevice foi preterido em vez do método RequestStateChange mais geral que se sobrepõe diretamente à funcionalidade fornecida por esse método.
Solicita que o LogicalDevice seja colocado online ("Online" parâmetro de entrada = TRUE) ou colocado offline (= FALSE). "Online" indica que o Dispositivo está pronto para aceitar solicitações e está operacional e em pleno funcionamento. Nesse caso, a propriedade Availability do dispositivo seria definida como um valor de 3 ("Running/Full Power"). "Offline" indica que um dispositivo está ligado e operacional, mas não processando solicitações funcionais. Em um estado offline, um dispositivo pode ser capaz de executar diagnósticos ou gerar alertas operacionais. Por exemplo, quando o botão "Offline" é pressionado em uma impressora, o dispositivo não está mais disponível para processar trabalhos de impressão, mas pode estar disponível para diagnóstico ou manutenção.
Se esse método for bem-sucedido, as propriedades Availability e AdditionalAvailability do dispositivo devem refletir o status atualizado. Se ocorrer uma falha ao tentar colocar o dispositivo online ou offline, ele deverá permanecer em seu estado atual. Ou seja, a solicitação, se não for bem-sucedida, não deve deixar o dispositivo em um estado indeterminado. Ao trazer um Dispositivo de volta "Online", de um modo "Offline", o Dispositivo deve ser restaurado para seu último estado "Online", se possível. Somente um dispositivo que tenha um EnabledState/StatusInfo de "Enabled" e tenha sido configurado pode ser colocado online ou colocado offline.
OnlineDevice deve retornar 0 se for bem-sucedido, 1 se a solicitação não for suportada, 2 se a solicitação não for suportada devido ao estado atual do dispositivo e algum outro valor se ocorrer qualquer outro erro. Em uma subclasse, o conjunto de códigos de retorno possíveis pode ser especificado, usando um qualificador ValueMap no método. As cadeias de caracteres para as quais o conteúdo do ValueMap é \'traduzido\' também podem ser especificadas na subclasse como um qualificador de matriz Values.
Observe que a função desse método se sobrepõe à propriedade RequestedState. RequestedState foi adicionado ao modelo para manter um registro (ou seja, um valor persistente) da última solicitação de estado. Invocar o método OnlineDevice deve definir a propriedade RequestedState apropriadamente.
Sintaxe
uint32 OnlineDevice(
[in] boolean Online
);
Parâmetros
-
Online [em]
-
Se TRUE, coloque o dispositivo online, se FALSE, coloque o dispositivo OFFLINE.
Valor retornado
TBD
Requisitos
| Cliente mínimo com suporte |
Windows 8 |
| Servidor mínimo com suporte |
Windows Server 2012 |
| Namespace |
Raiz\standardcimv2 |
| MOF |
|
| DLL |
|