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

Метод IVMGuestOS::SetParameter

  • Статья

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

Задает именованный параметр в гостевой операционной системе.

Синтаксис

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Параметры

inParameterName [in]

Имя параметра. Он должен содержать от 1 до 255 символов и не может содержать символ обратной косой черты (\).

inParameterValue [in]

Значение параметра.

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

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

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
E_INVALIDARG
0x80000003
 Параметр является недопустимым или не указан.
VM_E_TIMED_OUT
0xA0040202
 Операция не была завершена своевременно.
VM_E_VM_NOT_RUNNING
0xA0040206
 Виртуальная машина не запущена.
VM_E_VM_PAUSED
0xA00400507
 Виртуальная машина приостановлена.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Компоненты интеграции не установлены на этой виртуальной машине.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

Виртуальная машина должна быть запущена, а при вызове этого метода должны быть установлены компоненты интеграции. Этот метод поддерживается только для гостевых операционных систем под управлением Windows.

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

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

При запуске гостевой операционной системы в разделе Parameters заполняются следующие строковые значения реестра:

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS определяется как 99fea0db-4880-499a-b6d8-73dff9bc91be

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

IVMGuestOS