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

Метод IVMVirtualPC::CreateVirtualMachine

  • Статья

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

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

Синтаксис

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

Параметры

configurationName [in]

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

configurationPath [in]

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

virtualMachine [out, retval]

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

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

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

Возвращаемый код или значение Описание
S_OK
0
 Операция выполнена успешно.
E_POINTER
0x80004003
 Недопустимый параметр configurationName или configurationPath или параметр virtualMachine имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Системе не удается найти путь, указанный параметром 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_NO_NAME
0xA0040400
 Параметр configurationName пуст.
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