Метод IVMVirtualPC::CreateDynamicVirtualHardDisk

Статья
06/13/2023

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

Создает динамически изменяющийся размер виртуального жесткого диска.

Синтаксис

HRESULT CreateDynamicVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

Параметры

imagePath [in]: Полный путь к новому файлу образа диска. Если папка, содержащая ее, не существует, будет создана.
size [in]: Размер изображения в мегабайтах. Это значение может быть не более 2 088 960 МБ (2040 ГБ).
diskTask [out, retval]: Объект IVMTask , используемый для отслеживания создания образа.

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

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

Возвращаемый код/значение	Описание
S_OK 0	Операция выполнена успешно.
E_POINTER 0x80004003	Параметр имеет значение NULL.
E_INVALIDARG 0x80000003	Параметр size меньше или равен 0.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Системе не удается найти путь, указанный параметром imagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE) 0x8007000f	Файл, указанный параметром imagePath , находится на компакт-диске или DVD-диске.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Параметр imagePath содержит недопустимый символ (один из "*?:<>/\|").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Оба параметра imagePath указывают пустой или относительный путь. По крайней мере один из параметров должен быть абсолютным путем.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Путь, указанный параметром imagePath , слишком длинный. Длина пути не должна превышать 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	Произошла непредвиденная ошибка.

Требования

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

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

IVMVirtualPC

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