Класс Msvm_KvpExchangeComponent

Статья
06/13/2023

Представляет состояние службы обмена парами "ключ-значение", которая предоставляет механизм обмена данными между виртуальной машиной и операционной системой, работающей в операционной системе управления.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_KvpExchangeComponent : CIM_LogicalDevice
{
  string   InstanceID;
  string   Caption = "Key-Value Pair Exchange";
  string   Description = "Microsoft Key-Value Pair Exchange Service";
  string   ElementName = "Key-Value pair Exchange";
  datetime InstallDate;
  string   Name = "Key-Value Pair Exchange";
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 7;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_KvpExchangeComponent";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  string   GuestExchangeItems[];
  string   GuestIntrinsicExchangeItems[];
};

Члены

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

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

Методы

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

Метод	Описание
EnableDevice	Этот метод не поддерживается.
OnlineDevice	Этот метод не поддерживается.
QuiesceDevice	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния.
Reset	Сбрасывает компонент.
RestoreProperties	Этот метод не поддерживается.
Saveproperties	Этот метод не поддерживается.
SetPowerState	Этот метод не поддерживается.

Свойства

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

AdditionalAvailability

Тип данных: массив uint16
Тип доступа: только для чтения

Любые дополнительные сведения о доступности и состоянии устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
{ 6 }
6	Неприменимо

Доступность

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

Основная доступность и состояние устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
6	Неприменимо

AvailableRequestedStates

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement, но не используется.

Caption

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

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

CommunicationStatus

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

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

CreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_LogicalDevice.

Описание

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

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

DetailedStatus

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

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Ошибка, неизменяемая (4)
Ошибка поддержки сущности (5)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

DeviceID

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

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

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

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

Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
7	Нет значения по умолчанию

EnabledState

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

Включенное состояние элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

Включено (2)
Отключено (3)

ErrorCleared

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

Указывает, была ли теперь снята ошибка, сообщаемая в свойстве LastErrorCode . Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorDescription

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

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

GuestExchangeItems

Тип данных: строковый массив
Тип доступа: только для чтения
Квалификаторы: ArrayType ("Indexed"), HyperVEmbeddedInstance ("Msvm_KvpExchangeDataItem")

Массив внедренных экземпляров Msvm_KvpExchangeDataItem , содержащих набор пар "ключ-значение", которые службы, работающие в гостевой операционной системе, были отправлены, чтобы быть доступными для доступа внешними клиентами. Этот массив не будет содержать встроенные элементы, которые отправляются службой интеграции напрямую.

GuestIntrinsicExchangeItems

Тип данных: строковый массив
Тип доступа: только для чтения
Квалификаторы: ArrayType ("Indexed"), HyperVEmbeddedInstance ("Msvm_KvpExchangeDataItem")

Массив внедренных экземпляров Msvm_KvpExchangeDataItem , содержащих набор пар "ключ-значение", которые была отправлена гостевой операционной системой, чтобы быть доступными для доступа внешними клиентами. Этот массив не будет содержать элементы данных, отправленные другими службами, работающими в гостевой операционной системе.

HealthState

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

Текущая работоспособность элемента. Это выражает работоспособность этого элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент является полностью нефункциональным. Это свойство наследуется от CIM_ManagedSystemElement.

IdentifyingDescriptions

Тип данных: строковый массив
Тип доступа: только для чтения

Массив строк свободной формы, которые предоставляют пояснения и сведения о записях в массиве свойств OtherIdentifyingInfo . Это свойство наследуется от CIM_LogicalDevice, но не используется.

InstallDate

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

Дата и время установки службы интеграции на виртуальной машине. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

LastErrorCode

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

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

MaxQuiesceTime

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

Это свойство использовать не рекомендуется. Это свойство наследуется от CIM_LogicalDevice.

имя;

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

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

OperatingStatus

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

Предоставляет сведения о текущем состоянии для рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Обслуживание (2)
Начиная ( 3)
Остановка (4)
Остановлено (5)
Прервано (6)
Неактивный (7)
Завершено (8)
Миграция (9)
Эмигрирование (10)
Иммиграция (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

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

Ниже приведены возможные значения для значения свойства OperationalStatus[0].

Значение	Значение
OK 2	Служба работает в обычном режиме. Значения свойств OperationalStatus[1] и StatusDescriptions[1] могут содержать дополнительные сведения.
Деградация 3	Служба работает в обычном режиме, но гостевая служба согласует совместимую версию протокола связи. Значения свойств OperationalStatus[1] и StatusDescriptions[1] могут содержать дополнительные сведения.
Ошибка, неизменяемая 7	Гость не поддерживает совместимую версию протокола. Значения свойств OperationalStatus[1] и StatusDescriptions[1] могут содержать дополнительные сведения.
Нет контакта 12	Гостевая служба не установлена или еще не связалась с ней.
Потерянная связь 13	Гостевая служба больше не отвечает нормально.

OtherEnabledState

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

Строка, описывающая состояние включенного или отключенного элемента, если для свойства EnabledState задано значение 1 (Other). Это свойство должно иметь значение Null , если свойство EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Тип данных: строковый массив
Тип доступа: только для чтения

Любые дополнительные данные, помимо сведений об идентификаторе устройства, которые можно использовать для идентификации логического устройства. Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение Null.

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Возможности управления питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerManagementSupported

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

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

PowerOnHours

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

Количество часов подряд, в течение которых это устройство было включено с момента последнего цикла питания. Это свойство наследуется от CIM_LogicalDevice , но не используется.

PrimaryStatus

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

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать в сочетании со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
ОК (1)
Пониженная производительность (2)
Ошибка (3)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
12	Неприменимо

Состояние

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

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

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

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

StatusInfo

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

Текущее состояние логического устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

SystemCreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_LogicalDevice.

SystemName

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

Имя системы определения области. Это значение соответствует значению свойства Name класса Msvm_ComputerSystem для виртуальной машины области. Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastStateChange

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

Дата или время последнего изменения включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement, но не используется.

TotalPowerOnHours

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

Общее количество часов питания этого устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

TransitioningToState

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

Указывает целевое состояние, в которое переходит экземпляр. Это свойство наследуется от CIM_EnabledLogicalElement, но не используется.

Требования

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

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

CIM_LogicalDevice
CIM_LogicalDevice

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