Метод IVMVirtualPC::CreateDynamicVirtualHardDisk

  • Статья

[Виртуальный компьютер 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