UnwrapKeyProtector method of the MSFT_HgsKeyProtectorOperations class

  • Article

Unwraps an existing key protector returning the ingress key along with a new egress key and egress key protector.

Syntax

uint32 UnwrapKeyProtector(
  [in]  uint8 IngressKeyProtector[],
  [out] uint8 EncryptedTransferKey[],
  [out] uint8 EncryptedWrappingKey[],
  [out] uint8 EncryptedKeys[],
  [out] uint8 EgressKeyProtector[]
);

Parameters

IngressKeyProtector [in]

The key protector containing the desired transport key.

EncryptedTransferKey [out]

The transfer key encrypted to the caller.

EncryptedWrappingKey [out]

The wrapping key encrypted using the transfer key and the caller's trustlet information.

EncryptedKeys [out]

The key contained with the KP combined with a new export key contained in the egress KP.

EgressKeyProtector [out]

On success, contains the new egress Key Protector that describes the egress key.

Requirements
Minimum supported client
 Windows 10 [desktop apps only]
Minimum supported server
 Windows Server 2016
Namespace
 Root\Microsoft\Windows\Hgs
MOF
HgsClientWmi.mof
DLL
HgsClientWmi.dll

See also

MSFT_HgsKeyProtectorOperations