Метод IVMHardDisk::MergeTo

Статья
06/13/2023

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

Объединяет разностный виртуальный жесткий диск со всеми его родительскими элементами (вплоть до корневого родительского виртуального жесткого диска) в новый файл жесткого диска.

Синтаксис

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Параметры

newDiskImagePath [in]: Путь к новому целевому образу диска, в котором будут объединены выбранные образы дисков.
newDiskImageType [in]: Тип нового образа целевого диска. Для нового образа целевого диска разрешены типы образов vmDiskType_Dynamic и vmDiskType_FixedSize. Дополнительные сведения см. в статье VMHardDiskType.
mergeTask [out, retval]: Объект IVMTask , используемый для отслеживания завершения процесса слияния.

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

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

Возвращаемый код или значение	Описание
S_OK 0	Операция выполнена успешно.
E_POINTER 0x80004003	Параметр имеет значение NULL.
E_INVALIDARG 0x80000003	Параметр newDiskImagePath пуст.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Системе не удается найти файл, указанный параметром newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Системе не удается найти путь, указанный параметром newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Параметр newDiskImagePath содержит недопустимый символ (один из следующих: "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Параметр newDiskImagePath указывает пустой или относительный путь. Требуется абсолютный путь.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Слишком длинный путь, заданный параметром newDiskImagePath . Путь должен содержать менее 260 символов.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	Используется либо виртуальный жесткий диск, на который ссылается этот объект, либо родительский для этого виртуального жесткого диска.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Эта ошибка возникает из-за того, что образ виртуального жесткого диска, на который ссылается данный объект IVMHardDisk, не является разностным образом диска, или потому, что параметр newDiskImageType не является одним из допустимых значений , vmDiskType_Dynamic или vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Файл, на который ссылается новый параметрDiskImagePath , уже существует.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	На томе узла недостаточно места для объединения этого виртуального жесткого диска.
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

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