Метод IVMVirtualPC::FindVirtualMachine

  • Статья

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

Извлекает объект виртуальной машины, соответствующий запрошенной конфигурации.

Синтаксис

HRESULT FindVirtualMachine(
  [in]          BSTR              configurationName,
  [out, retval] IVMVirtualMachine **virtualMachine
);

Параметры

configurationName [in]

Имя найденной виртуальной машины.

virtualMachine [out, retval]

Указатель на новый объект IVMVirtualMachine , представляющий эту виртуальную машину.

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

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

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
S_FALSE
1
 Не удалось найти указанную конфигурацию.
E_POINTER
0x80004003
 Недопустимый параметр configurationName или параметр virtualMachine имеет значение NULL.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Процессор не поддерживает расширения аппаратной ускоренной виртуализации (HAV).

Комментарии

Имена виртуальных машин не учитывают регистр, например MyVM и myvm относятся к одной виртуальной машине.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC определяется как 236ba0d9-a24a-4292-a132-27c1421dfd01

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

IVMVirtualPC