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

Метод IVMHardDisk::Convert

  • Статья

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

Преобразует виртуальный жесткий диск фиксированного размера в динамически расширяющийся виртуальный жесткий диск или преобразует динамически расширяющийся виртуальный жесткий диск в виртуальный жесткий диск фиксированного размера.

Синтаксис

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Параметры

convertedDiskImagePath [in]

Путь к файлу целевого образа диска.

convertedDiskImageType [in]

Тип целевого образа диска. Список значений см. в разделе VMHardDiskType.

convertTask [out, retval]

Объект IVMTask , используемый для отслеживания завершения процесса преобразования.

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

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

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
E_INVALIDARG
0x80000003
 Параметр convertedDiskImagePath пуст или отсутствует расширение VHD в имени файла.
E_POINTER
0x80004003
 Параметр имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Системе не удается найти путь, указанный параметром convertedDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Параметр convertedDiskImagePath содержит недопустимый символ (один из "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Параметр convertedDiskImagePath указывает пустой или относительный путь. Требуется абсолютный путь.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Слишком длинный путь, указанный параметром convertedDiskImagePath . Путь должен быть меньше MAX_PATH (260) символов.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Используется либо виртуальный жесткий диск, на который ссылается этот объект, либо родительский для этого виртуального жесткого диска.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 На томе узла недостаточно места для преобразования этого виртуального жесткого диска.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Файл, на который ссылается параметр convertedDiskImagePath , уже существует.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Параметр convertedDiskImagePath должен быть vmDiskType_Dynamic или vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE
0xA0040682
 Образ виртуального жесткого диска, на который ссылается этот объект IVMHardDisk , не является допустимым образом.
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
 Родительский элемент виртуального жесткого диска, на который ссылается этот объект, не существует.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 Невозможно преобразовать образ виртуального жесткого диска, так как приложение завершает работу.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

Исходный файл остается без изменений после преобразования.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMHardDisk определяется как ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

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

IVMHardDisk