Метод IVMVirtualMachine::AddHardDiskConnection

  • Статья

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

Добавляет новое подключение к жесткому диску к виртуальной машине.

Синтаксис

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

Параметры

hardDiskPath [in]

Полный путь к файлу виртуального жесткого диска (VHD) для подключения.

busNumber [in]

Автобус, к которому будет подключен диск.

Значение Значение
0
 Диск будет подключен к первой шине.
1
 Диск будет прикреплен ко второму автобусу.

deviceNumber [in]

Устройство, к которому будет подключен диск.

Значение Значение
0
 Диск будет подключен к первому устройству в шине.
1
 Диск будет подключен ко второму устройству в шине.

hardDiskConnection [out, retval]

Объект IVMHardDiskConnection .

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

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

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
E_POINTER
0x80004003
 Параметр hardDiskConnection имеет значение NULL.
E_INVALIDARG
0x80000003
 Параметр hardDiskPath имеет значение NULL или недопустимый параметр busNumber или deviceNumber .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Системе не удается найти файл, указанный параметром hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Системе не удается найти путь, указанный параметром hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Параметр hardDiskPath содержит недопустимый символ (один из "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Параметр hardDiskPath указывает пустой или относительный путь. Требуется абсолютный путь.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Путь, указанный параметром hardDiskPath , слишком длинный. Путь должен содержать менее 260 символов.
VM_E_VM_UNKNOWN
0xA0040207
 Конфигурация неизвестна.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 Виртуальная машина находится в запущенном или сохраненном состоянии.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 Используется указанное расположение шины.
VM_E_INVALID_HD_FILE
0xA0040682
 Объем виртуального жесткого диска превышает 127 ГБ и не может быть подключен к шине интегрированной среды разработки.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 Параметр hardDiskPath ссылается на связанный виртуальный жесткий диск или разностный виртуальный жесткий диск со связанным виртуальным жестким диском. Связанные виртуальные жесткие диски не могут быть подключены к виртуальным машинам.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Указанный виртуальный жесткий диск уже подключен к другому расположению шины для этой виртуальной машины.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

Новое подключение к жесткому диску можно добавить только к остановленной виртуальной машине.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine определяется как f7092aa1-33ed-4f78-a59f-c00adfc2edd7

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

IVMVirtualMachine