ChangeManagementKey Method

ChangeManagementKey(ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>)

Change the management key, throw an exception if the operation failed.

C#

public void ChangeManagementKey(ReadOnlyMemory<byte> currentManagementKey, ReadOnlyMemory<byte> newManagementKey)

Parameters

Type	Name	Description
System.ReadOnlyMemory<System.Byte>	currentManagementKey	The current value of the management key. It must be exactly 16 bytes long (see ValidManagementKeyLength). The default value is all zeros.
System.ReadOnlyMemory<System.Byte>	newManagementKey	The new value of the management key. It must be exactly 16 bytes long (see ValidManagementKeyLength).

Exceptions

Type	Condition
System.Security.SecurityException	The currentManagementKey was incorrect.

Remarks

There is a limit of 8 attempts to authenticate with the management key before the management key is blocked. Once the management key is blocked, the application must be reset before performing operations which require authentication with the management key (such as adding credentials, deleting credentials, and changing the management key). To reset the application, see ResetApplication(). Supplying the correct management key before the management key is blocked will reset the retry counter to 8.