Интерфейс 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. |