GetKeyProtector method of the Msvm_SecurityService class

Retrieves the key protector for a virtual system.

Syntax

uint32 GetKeyProtector(
  [in]  string SecuritySettingData,
  [out] uint8  KeyProtector[]
);

Parameters

SecuritySettingData [in]

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

KeyProtector [out]

Receives the raw byte array that contains the key protector currently in use.

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