CngKey::Create Method (CngAlgorithm^, String^, CngKeyCreationParameters^)

 

Creates a named CngKey object that provides the specified algorithm, using the supplied key creation parameters.

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

public:
static CngKey^ Create(
	CngAlgorithm^ algorithm,
	String^ keyName,
	CngKeyCreationParameters^ creationParameters
)

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.

creationParameters
Type: System.Security.Cryptography::CngKeyCreationParameters^

An object that specifies advanced parameters for the method, including the CngProvider.

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.

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: