Метод IVMVirtualPC::CreateDifferencingVirtualHardDisk

Статья
06/13/2023

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

Создает разностный виртуальный жесткий диск.

Синтаксис

HRESULT CreateDifferencingVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          BSTR    parentPath,
  [out, retval] IVMTask **diskTask
);

Параметры

imagePath [in]: Путь к новому файлу образа диска. Если папка, содержащая ее, будет создана, если она не существует.
parentPath [in]: Путь к файлу родительского образа диска.
diskTask [out, retval]: Объект IVMTask , используемый для отслеживания создания образа.

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

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

Возвращаемый код или значение	Описание
S_OK 0	Операция выполнена успешно.
E_POINTER 0x80004003	Параметр имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Системе не удается найти путь, указанный параметром imagePath или parentPath .
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE) 0x8007000f	Файл, указанный параметром imagePath , находится на компакт-диске или DVD-диске.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Параметр imagePath или parentPath содержит недопустимый символ (один из "*?:<>/\|").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Параметры imagePath и parentPath указывают пустой или относительный путь. По крайней мере один из параметров должен быть абсолютным путем.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Путь, заданный параметрами imagePath или parentPath , слишком длинный. Длина пути не должна превышать 260 символов.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Файл, на который ссылается параметр imagePath, уже существует.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	Для динамического расширения образа виртуального жесткого диска требуется по крайней мере 8 МБ бесплатно на томе узла.
VM_E_IMAGE_SIZE_TOO_LARGE 0xA0040683	Размер параметра должен быть меньше 2 088 960 МБ. Если используется формат FAT16, размер должен быть меньше 2000 МБ.
VM_E_IMAGE_SIZE_TOO_SMALL 0xA0040684	Неформатированные образы виртуальных жестких дисков и образы виртуальных дисков в формате FAT16 должны иметь размер не менее 3 МБ. Размер образов виртуальных жестких дисков в формате FAT32 должен быть не менее 514 МБ.
VM_E_FILE_TOO_LARGE_FOR_VOLUME 0xA0040679	Том узла не может поддерживать файл такого размера, если динамически расширяющийся образ виртуального жесткого диска расширяется до полного предела. Максимальный размер файла для тома FAT32 составляет 4 ГБ. Максимальный размер файла для тома FAT16 составляет 2 ГБ.
VM_E_APP_SHUTTING_DOWN 0xA0040209	После завершения работы приложения невозможно создать виртуальный жесткий диск.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Процессор не поддерживает расширения аппаратной ускоренной виртуализации (HAV).
DISP_E_EXCEPTION 0x80020009	Произошла непредвиденная ошибка.

Хотя imagePath или parentPath может быть относительным путем, по крайней мере один из них должен быть абсолютным путем. Если один параметр пути является относительным, предполагается, что он относительно другого параметра пути.

Требования

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

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

IVMVirtualPC

Share via