Метод OnlineDevice класса CIM_LogicalPort
Метод OnlineDevice не рекомендуется использовать вместо более общего метода RequestStateChange, который напрямую перекрывается функциональными возможностями, предоставляемыми этим методом.
Запрашивает, чтобы логическийDevice был доставлен в режим "онлайн" входной параметр = TRUE) или отключен (= FALSE). "Online" указывает, что устройство готово принимать запросы и работает полностью. В этом случае свойство доступности Device\s будет иметь значение 3 ("Выполнение или полная мощность"). "Автономный" указывает, что устройство работает и работает, но не обрабатывает функциональные запросы. В автономном состоянии устройство может работать диагностика или создавать операционные оповещения. Например, при нажатии кнопки "Автономный" на принтере устройство больше не доступно для обработки заданий печати, но может быть доступно для диагностика или обслуживания.
Если этот метод выполнен успешно, свойства доступности device\s и AdditionalAvailability должны отражать обновленное состояние. Если сбой возникает при попытке перенести устройство в режим "в сети" или "в автономном режиме", он должен оставаться в текущем состоянии. IE, запрос, если не удается, не должен покидать устройство в неопределенном состоянии. При возврате устройства обратно из режима "Автономный" устройство должно быть восстановлено до последнего состояния "Онлайн", если это возможно. Только устройство с включенным параметром "EnabledState/StatusInfo" (Включено) и настроено для подключения к сети или автономного использования.
OnlineDevice должен возвращать значение 0 в случае успешного выполнения, 1, если запрос не поддерживается вообще, 2, если запрос не поддерживается из-за текущего состояния устройства, а также другое значение, если произошла другая ошибка. В подклассе можно указать набор возможных кодов возврата с помощью квалификатора ValueMap в методе. Строки, в которых содержимое ValueMap имеют значение \'translated\', также могут быть указаны в подклассе в качестве квалификатора массива значений.
Обратите внимание, что функция этого метода перекрывается свойством RequestedState. RequestState был добавлен в модель для поддержания записи (т. е. сохраняемого значения) последнего запроса состояния. Вызов метода OnlineDevice должен соответствующим образом задать свойство RequestedState.
Синтаксис
uint32 OnlineDevice(
[in] boolean Online
);
Параметры
-
Online [in]
-
Если значение TRUE, перейдите к устройству в режим "в сети", если значение FALSE, перейдите к устройству в автономном режиме.
Возвращаемое значение
Подлежит уточнению
Требования
| Минимальная версия клиента |
Windows 8 |
| Минимальная версия сервера |
Windows Server 2012 |
| Пространство имен |
Root\standardcimv2 |
| MOF |
|
| DLL-библиотеки |
|