Метод IVMVirtualPC::RegisterVirtualMachine

  • Статья

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

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

Синтаксис

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

Параметры

configurationName [in]

Имя зарегистрированной виртуальной машины. Длина имени не может превышать 80 символов, а общая длина имени и пути не может превышать MAX_PATH (260) символов. Указанное имя может содержать расширение VMC. Если этот параметр имеет значение NULL или пустую строку, параметр configurationPath должен указывать полный путь к файлу конфигурации.

configurationPath [in]

Путь к папке, содержащей существующий файл конфигурации. Если параметр configurationName имеет значение NULL или пустую строку, необходимо указать полный путь к существующему файлу конфигурации.

virtualMachine [out, retval]

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

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

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

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
E_POINTER
0x80004003
 Недопустимый параметр configurationName или configurationPath либо параметр virtualMachine имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Системе не удается найти путь, указанный параметрами configurationName и configurationPath .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Системе не удается найти файл, указанный параметрами configurationName и configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Параметр configurationPath содержит недопустимый символ (один из "*?:<>/|").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Параметр configurationPath указывает пустой или относительный путь. Требуется абсолютный путь.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Путь, указанный параметрами configurationName и configurationPath , приводит к слишком длинному пути. Общая длина пути должна быть меньше MAX_PATH (260) символов.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Файл конфигурации с таким именем уже существует в этом расположении.
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 Длина параметра configurationName превышает 80 символов.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 Параметр configurationName содержит недопустимый символ (один из "*?:<>/|\").
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Уже существует виртуальная машина с таким именем.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Процессор не поддерживает расширения аппаратной ускоренной виртуализации (HAV).
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

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

Требования

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

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

IVMVirtualPC