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

Свойство IVMVirtualMachine::Name

  • Статья

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

Извлекает и задает имя конфигурации виртуальной машины.

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

Значение свойства

Указывает имя конфигурации виртуальной машины. Длина имени не может превышать 80 символов, а общая длина полного пути, содержащего файл конфигурации имени виртуальной машины, не может превышать MAX_PATH (260) символов.

Коды ошибок

Имя/значение Значение
S_OK
0
 Операция выполнена успешно.
E_POINTER
0x80004003
 Параметр имеет значение NULL.
E_INVALIDARG
0x80000003
 Параметр является недопустимым или является пустой строкой.
VM_E_VM_UNKNOWN
0xA0040207
 Конфигурация неизвестна.
VM_E_PREF_VM_ACTIVE
0xA0040302
 Виртуальная машина запущена или сохранена.
VM_E_CONFIG_NO_NAME
0xA0040400
 Параметр virtualMachineName пуст.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 Параметр содержит слишком много символов.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 Параметр содержит один из следующих недопустимых символов "*?:<>/|\".
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Указанное имя уже существует в качестве имени другой виртуальной машины.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

Имена виртуальных машин не учитывают регистр, например MyVM и myvm относятся к одной виртуальной машине. Это свойство по умолчанию для IVMVirtualMachine.

Если VPC.exe запущена и виртуальная машина сохранена, установка свойства Name не будет выполнена. Если VPC.exe не запущен и виртуальная машина сохранена, установка свойства Name будет успешной при следующем запуске VPC.exe.

Требования

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

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

IVMVirtualMachine