SetKeyProtector method of the Msvm_SecurityService class

Sets the key protector for a virtual system.

Syntax

uint32 SetKeyProtector(
  [in]  string              SecuritySettingData,
  [in]  uint8               KeyProtector[],
  [out] CIM_ConcreteJob REF Job
);

Parameters

SecuritySettingData [in]

String contains an embedded instance of the Msvm_SecuritySettingData class representing the security settings of a virtual system.

KeyProtector [in]

Raw byte array that contains the key protector to set.

Job [out]

An optional parameter for monitoring progress of the operation, which is used if the method could not be executed synchronously. If the operation is executing asynchronously, the return value is 4096.

Return value

On success, returns a 0 or 4096; otherwise, returns an error.

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

Requirement Value
Minimum supported client
Windows 10, version 1703 [desktop apps only]
Minimum supported server
Windows Server 2016
Namespace
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

Msvm_SecurityService