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

Статья
06/13/2023

[Виртуальный компьютер 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	Произошла непредвиденная ошибка.

Если 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