AddKvpItems method of the Msvm_VirtualSystemManagementService class

Adds key-value pairs to a virtual system.

Syntax

uint32 AddKvpItems(
  [in]  CIM_ComputerSystem REF TargetSystem,
  [in]  string                 DataItems[],
  [out] CIM_ConcreteJob    REF Job
);

Parameters

TargetSystem [in]

A reference to the virtual computer system that receives the added key-value pairs.

DataItems [in]

An array that contains the key-value pairs to add. Each element of the array is an embedded instance of the Msvm_KvpExchangeDataItem class. This method fails if any of the key-value pairs already exists on the target system. This array can contain up to 128 elements.

Job [out]

A reference to an optional job for the operation if the operation is run asynchronously.

Return value

The possible values are:

Completed with No Error (0)

Method Parameters Checked - Job Started (4096)

Failed (32768)

Access Denied (32769)

Not Supported (32770)

Status is unknown (32771)

Timeout (32772)

Invalid parameter (32773)

System is in use (32774)

Invalid state for this operation (32775)

Incorrect data type (32776)

System is not available (32777)

Out of memory (32778)

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2016
Namespace
Root\HyperVCluster\v2
MOF
WindowsHyperVCluster.V2.mof
DLL
VMMS.exe

See also

Msvm_VirtualSystemManagementService