Интерфейс IVMGuestOS
[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]
Определяет операционную систему на виртуальной машине на виртуальной машине. Этот интерфейс позволяет взаимодействовать с компонентами интеграции, работающими в гостевой операционной системе. IvMGuestOS для виртуальной машины можно получить с помощью свойства IVMVirtualMachine::GuestOS.
Интерфейс IVMGuestOS наследуется от интерфейса IDispatch . IVMGuestOS также имеет следующие типы элементов:
Интерфейс IVMGuestOS содержит следующие методы.
Метод | Описание |
---|---|
GetOsVersionInfo | Извлекает сведения о версии для гостевой операционной системы, работающей на виртуальной машине. |
GetParameter | Извлекает именованный параметр в гостевой системе. |
InstallIntegrationComponents | Находит и устанавливает последнюю версию компонентов интеграции в гостевой операционной системе. |
IsUserLoggedOn | Определяет, присутствует ли запрошенный сеанс. |
Выхода | Выключает всех пользователей из гостевой операционной системы. |
Перезагрузить | Перезапускает операционную систему на виртуальной машине. |
SetParameter | Задает именованный параметр в гостевой системе. |
Завершить работу | Завершает работу гостевой операционной системы. |
Интерфейс IVMGuestOS имеет следующие свойства.
Свойство | Тип доступа | Описание |
---|---|---|
CanShutdown |
Только для чтения |
Указывает, можно ли полностью завершить работу гостевой операционной системы (требуются компоненты интеграции). |
ИмяКомпьютера |
Только для чтения |
Имя компьютера гостевой операционной системы, работающей на виртуальной машине. |
CSDVersion |
Только для чтения |
CSDVersion гостевой операционной системы, работающей на виртуальной машине. |
HeartbeatPercentage |
Только для чтения |
Процент ожидаемых пульсов, полученных за последнюю минуту. |
IntegrationComponentsVersion |
Только для чтения |
Версия компонентов интеграции, установленных в гостевой операционной системе. |
IsHeartbeating |
Только для чтения |
Указывает, имеет ли виртуальная машина пульс. |
IsHostTimeSyncEnabled |
Чтение/запись |
Указывает, должны ли компоненты интеграции на этой виртуальной машине синхронизировать часы гостя с часами узла. |
MultipleUserSessionsAllowed |
Только для чтения |
Указывает, разрешено ли несколько одновременных сеансов пользователя в гостевой операционной системе. |
OSBuildNumber |
Только для чтения |
Номер сборки гостевой операционной системы, работающей на виртуальной машине. |
OSMajorVersion |
Только для чтения |
Основная версия гостевой операционной системы, работающей на виртуальной машине. |
OSMinorVersion |
Только для чтения |
Дополнительный номер версии гостевой операционной системы, работающей на виртуальной машине. |
ИМЯ OSName |
Только для чтения |
Имя гостевой операционной системы, работающей на виртуальной машине. |
OSPlatformId |
Только для чтения |
Идентификатор платформы гостевой операционной системы, работающей на виртуальной машине. |
OSVersion |
Только для чтения |
Версия гостевой операционной системы, работающей на виртуальной машине. |
Тип продукта |
Только для чтения |
Тип продукта гостевой операционной системы, работающей на виртуальной машине. |
Экран заблокирован |
Только для чтения |
Указывает, заблокирован ли экран в гостевой операционной системе. |
ServicePackMajor |
Только для чтения |
Основная версия пакета обновления гостевой операционной системы, работающей на виртуальной машине. |
ServicePackMinor |
Только для чтения |
Дополнительный номер версии пакета обновления гостевой операционной системы, работающей на виртуальной машине. |
SuiteMask |
Только для чтения |
SuiteMask гостевой операционной системы, работающей на виртуальной машине. |
TerminalServerPort |
Только для чтения |
Порт, используемый службами удаленных рабочих столов в гостевой операционной системе. |
TerminalServicesInitialized |
Только для чтения |
Состояние инициализации служб терминалов в гостевой операционной системе. |
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 7 [только классические приложения] |
Минимальная версия сервера |
Ни одна версия не поддерживается |
Окончание поддержки клиентов |
Windows 7 |
Продукт |
Windows Virtual PC |
Заголовок |
|
IID |
IID_IVMGuestOS определяется как 99fea0db-4880-499a-b6d8-73dff9bc91be. |