ChangeManagementKey Method
ChangeManagementKey(ReadOnlyMemory<byte>, ReadOnlyMemory<byte>)
Change the management key, throw an exception if the operation failed.
public void ChangeManagementKey(ReadOnlyMemory<byte> currentManagementKey, ReadOnlyMemory<byte> newManagementKey)Parameters
| Type | Name | Description |
|---|---|---|
| ReadOnlyMemory<byte> | currentManagementKey | The current value of the management key. It must be exactly 16 bytes long (see ValidManagementKeyLength). The default value is all zeros. |
| ReadOnlyMemory<byte> | newManagementKey | The new value of the management key. It must be exactly 16 bytes long (see ValidManagementKeyLength). |
Exceptions
| Type | Condition |
|---|---|
| SecurityException | The |
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.