Поделиться через


Метод IVMGuestOS::Restart

[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]

Перезапускает операционную систему на виртуальной машине.

Синтаксис

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

Параметры

inForced [in]

VARIANT_TRUE , если требуется принудительный перезапуск, и VARIANT_FALSE в противном случае.

outRestartTask [out, retval]

Объект IVMTask , используемый для отслеживания хода выполнения последовательности перезапуска.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемый код/значение Описание
S_OK
0
Операция выполнена успешно.
E_POINTER
0x80004003
Параметр outRestartTask имеет значение NULL.
DISP_E_EXCEPTION
0x80020009
Произошла непредвиденная ошибка.
VM_E_TIMED_OUT
0xA0040202
Операция не была завершена своевременно.
VM_E_VM_NOT_RUNNING
0xA0040206
Для этой операции должна быть запущена виртуальная машина.
VM_E_VM_UNKNOWN
0xA0040207
Конфигурация неизвестна.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
Компонент компонентов интеграции не установлен на этой виртуальной машине.

Комментарии

Следующие значения можно вернуть с помощью свойства Error возвращенного объекта IVMTask .

Код/значение ошибки Описание
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) (0x80070005)
Вызывающий объект должен иметь разрешения на выполнение для этой виртуальной машины.
HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED) (0x800704f7)
Компьютер заблокирован и не может быть выключен без параметра force.
HRESULT_FROM_WIN32(ERROR_NOT_READY) (0x80070015)
Устройство не готово.
HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS) (0x8007045b)
Выполняется завершение работы системы.

Требования

Требование Значение
Минимальная версия клиента
Windows 7 [только классические приложения]
Минимальная версия сервера
Ни одна версия не поддерживается
Окончание поддержки клиентов
Windows 7
Продукт
Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
IID_IVMGuestOS определяется как 99fea0db-4880-499a-b6d8-73dff9bc91be

См. также раздел

IVMGuestOS