Класс Msvm_GuestServiceInterfaceComponent

Представляет состояние компонента интерфейса гостевой службы, который предоставляет механизм для взаимодействия с виртуальной машиной из интерфейсов управления в хост-системе. Этот класс является производным от класса CIM_LogicalDevice .

Следующий синтаксис упрощен из MOF-кода и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponent : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Члены

Класс Msvm_GuestServiceInterfaceComponent имеет следующие типы членов:

• Методы
• Свойства

Методы

Класс Msvm_GuestServiceInterfaceComponent содержит следующие методы.

Метод	Описание
RequestStateChange	Запрашивает изменение состояния компонента интерфейса гостевой службы на указанное значение.
Reset	Запрашивает сброс логического устройства. Не реализован инструментарием WMI.
SetPowerState	Определяет требуемое состояние питания для логического устройства и время, когда устройство должно быть переведено в это состояние. Не реализован инструментарием WMI.

Свойства

Класс Msvm_GuestServiceInterfaceComponent имеет следующие свойства.

Доступность

Тип данных: uint16

Тип доступа: только для чтения

Доступность и состояние устройства.

Значение	Значение
Другое 1 (0x1)
Unknown 2 (0x2)
Работа/полная мощность 3 (0x3)
Предупреждение 4 (0x4)
В тесте 5 (0x5)
Неприменимо 6 (0x6)
Выключение 7 (0x7)
Off Line 8 (0x8)
Без обязанностей 9 (0x9)
Деградация 10 (0xA)
Не установлено 11 (0xB)
Ошибка при установке 12 (0xC)
Энергосбережение — неизвестно 13 (0xD)	Известно, что устройство находится в режиме энергопотребления, но его точное состояние неизвестно.
Экономия энергии — режим низкого энергопотребления 14 (0xE)	Устройство находится в состоянии экономии электроэнергии, но по-прежнему работает и может демонстрировать снижение производительности.
Экономия электроэнергии в режиме ожидания 15 (0xF)	Устройство не работает, но может быть быстро приведено в полную мощность.
Цикл питания 16 (0x10)
Экономия электроэнергии — предупреждение 17 (0x11)	Устройство находится в состоянии предупреждения, но также в режиме энергопотребления.

Caption

Тип данных: string

Тип доступа: только для чтения

Краткое текстовое описание объекта. Это свойство наследуется от CIM_ManagedSystemElement.

ConfigManagerErrorCode

Тип данных: uint32

Тип доступа: только для чтения

Код ошибки Configuration Manager Win32.

Значение	Значение
0 (0x0)	Устройство работает правильно.
1 (0x1)	Устройство настроено неправильно.
2 (0x2)	Windows не может загрузить драйвер для этого устройства.
3 (0x3)	Драйвер для этого устройства может быть поврежден или в системе может быть недостаточно памяти или других ресурсов.
4 (0x4)	Устройство работает неправильно. Один из его драйверов или реестр может быть поврежден.
5 (0x5)	Драйверу для устройства требуется ресурс, которым Windows не может управлять.
6 (0x6)	Конфигурация загрузки для устройства конфликтует с другими устройствами.
7 (0x7)	Не удается выполнить фильтрацию.
8 (0x8)	Отсутствует загрузчик драйвера для устройства.
9 (0x9)	Устройство работает неправильно; управляющее встроенное ПО неправильно сообщает о ресурсах для устройства.
10 (0xA)	Устройство не может запуститься.
11 (0xB)	Сбой устройства.
12 (0xC)	Устройство не может найти достаточно свободных ресурсов для использования.
13 (0xD)	Windows не может проверить ресурсы устройства.
14 (0xE)	Устройство не может работать должным образом, пока компьютер не перезагрузится.
15 (0xF)	Устройство работает неправильно из-за возможной проблемы с повторным перечислением.
16 (0x10)	Windows не может определить все ресурсы, используемые устройством.
17 (0x11)	Устройство запрашивает неизвестный тип ресурса.
18 (0x12)	Драйверы устройств необходимо переустановить.
19 (0x13)	Сбой при использовании загрузчика VxD.
20 (0x14)	Реестр может быть поврежден.
21 (0x15)	Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию. Windows удаляет устройство.
22 (0x16)	Устройство отключено.
23 (0x17)	Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию.
24 (0x18)	Устройство отсутствует, не работает должным образом или на нем установлены не все драйверы.
25 (0x19)	Windows по-прежнему настраивает устройство.
26 (0x1A)	Windows по-прежнему настраивает устройство.
27 (0x1B)	Устройство не имеет допустимой конфигурации журнала.
28 (0x1C)	Драйверы устройств не установлены.
29 (0x1D)	Устройство отключено; встроенное ПО устройства не предоставило необходимых ресурсов.
30 (0x1E)	Устройство использует ресурс IRQ, который использует другое устройство.
31 (0x1F)	Устройство работает неправильно; Windows не может загрузить необходимые драйверы устройств.

ConfigManagerUserConfig

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение TRUE, устройство использует определяемую пользователем конфигурацию.

CreationClassName

Тип данных: string

Тип доступа: только для чтения

Имя класса или подкласса, используемого при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры класса и его подклассы.

Описание

Тип данных: string

Тип доступа: только для чтения

Текстовое описание объекта. Это свойство наследуется от CIM_ManagedSystemElement.

DeviceID

Тип данных: string

Тип доступа: только для чтения

Адрес или другие идентифицирующие сведения для уникального имени логического устройства.

ErrorCleared

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение TRUE, ошибка, указанная в свойстве LastErrorCode , теперь удаляется.

ErrorDescription

Тип данных: string

Тип доступа: только для чтения

Строка свободной формы, которая предоставляет сведения об ошибке, записанной в свойстве LastErrorCode , и корректирующие действия, которые необходимо выполнить.

InstallDate

Тип данных: datetime

Тип доступа: только для чтения

Дата и время установки объекта. Этому свойству не требуется значение, указывающее, что объект установлен. Это свойство наследуется от CIM_ManagedSystemElement.

LastErrorCode

Тип данных: uint32

Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством.

имя;

Тип данных: string

Тип доступа: только для чтения

Метка, по которой известен объект. При подклассе это свойство может быть переопределено как ключевое свойство. Это свойство наследуется от CIM_ManagedSystemElement.

PNPDeviceID

Тип данных: string

Тип доступа: только для чтения

Указывает идентификатор логического устройства Plug and Play Win32.

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16

Тип доступа: только для чтения

Массив конкретных возможностей логического устройства, связанных с питанием. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
Unknown 0 (0x0)
Не поддерживается 1 (0x1)
Отключено 2 (0x2)
Enabled 3 (0x3)	Функции управления питанием в настоящее время включены, но точный набор функций неизвестен или информация недоступна.
Режимы энергосбережения, введенные автоматически 4 (0x4)	Устройство может изменять состояние питания в зависимости от использования или других критериев.
Power State Settable 5 (0x5)	Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.
Поддерживается цикличность питания 6 (0x6)	Метод SetPowerState можно вызвать с параметром PowerState, равным 5 ("Цикл питания").
Поддержка включения по времени 7 (0x7)	Метод SetPowerState можно вызвать с параметром PowerState, равным 5 ("Цикл питания"), а для параметра Time задана определенная дата и время или интервал для включения питания.

PowerManagementSupported

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение TRUE, устройство может управляться питанием, то есть переходить в состояние экономии энергии. Если значение РАВНО FALSE, целочисленное значение 1 ("Не поддерживается") должно быть единственной записью в массиве PowerManagementCapabilities .

Это свойство не указывает, включены ли функции управления питанием в настоящее время или, если они включены, какие функции поддерживаются. Дополнительные сведения см. в статье Массив PowerManagementCapabilities .

Состояние

Тип данных: string

Тип доступа: только для чтения

Текущее состояние объекта. Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

"ОК"

"Ошибка"

"Пониженная производительность"

"Неизвестно"

"Pred Fail"

"Запуск"

"Остановка"

"Служба"

"Подчеркнуто"

"Невосстановимый"

"Нет контакта"

"Lost Comm"

StatusInfo

Тип данных: uint16

Тип доступа: только для чтения

Состояние логического устройства. Если это свойство не применяется к логическому устройству, следует использовать значение 5 ("Неприменимо"). Это свойство наследуется от CIM_LogicalDevice.

Другое (1 (0x1))

Неизвестно (2 (0x2))

Включено (3 (0x3))

Отключено (4 (0x4))

Неприменимо (5 (0x5))

SystemCreationClassName

Тип данных: string

Тип доступа: только для чтения

Имя класса создания системы области.

SystemName

Тип данных: string

Тип доступа: только для чтения

Имя системы определения области.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 R2 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

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

CIM_LogicalDevice

CIM_LogicalDevice