CngKey::Create Method (CngAlgorithm^, String^, CngKeyCreationParameters^)
Creates a named CngKey object that provides the specified algorithm, using the supplied key creation parameters.
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.
for permission to create a key container. Demand value: Demand. Associated enumeration: KeyContainerPermissionFlags::Create
Available since 3.5