CngKey.Create Method (CngAlgorithm, String)

 

Creates a named CngKey object that provides the specified algorithm.

Namespace:   System.Security.Cryptography
Assembly:  System.Core (in System.Core.dll)

public static CngKey Create(
	CngAlgorithm algorithm,
	string keyName
)

Parameters

algorithm
Type: System.Security.Cryptography.CngAlgorithm

The algorithm that the key will be used with.

keyName
Type: System.String

The key name. If a name is not provided, the key will not be persisted.

Return Value

Type: System.Security.Cryptography.CngKey

A persisted or ephemeral key that provides the specified algorithm.

Exception Condition
ArgumentNullException

algorithm is null.

PlatformNotSupportedException

Cryptography Next Generation (CNG) is not supported on this system.

CryptographicException

All other errors.

If keyName is provided, this overload creates a persisted key. If keyName is not provided, the key will be ephemeral. This overload also creates a default CngKeyCreationParameters object that specifies a default CngProvider and other advanced parameters for the key.

KeyContainerPermissionAccessEntryCollection

for permission to create a key container. Demand value: Demand. Associated enumeration: KeyContainerPermissionFlags.Create

.NET Framework
Available since 3.5
Return to top
Show: