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

Метод IVMGuestOS::Shutdown

  • Статья

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

Завершает работу гостевой операционной системы на виртуальной машине.

Синтаксис

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Параметры

isForced [in]

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

outShutdownTask [out, retval]

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

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

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

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

Комментарии

Виртуальная машина должна быть запущена, а при вызове этого метода должен быть установлен компонент компонентов интеграции. Этот метод поддерживается только для гостевых операционных систем под управлением Windows.

Следующие значения можно вернуть с помощью свойства 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