Интерфейс 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
Заголовок
VPCCOMInterfaces.h
IID
IID_IVMGuestOS определяется как 99fea0db-4880-499a-b6d8-73dff9bc91be.