CngKey::Open Method (SafeNCryptKeyHandle^, CngKeyHandleOpenOptions)
Creates an instance of an CngKey object by using a handle to an existing key.
Assembly: System.Core (in System.Core.dll)
public: [SecurityCriticalAttribute] [SecurityPermissionAttribute(SecurityAction::Demand, UnmanagedCode = true)] static CngKey^ Open( SafeNCryptKeyHandle^ keyHandle, CngKeyHandleOpenOptions keyHandleOpenOptions )
Parameters
- keyHandle
-
Type:
Microsoft.Win32.SafeHandles::SafeNCryptKeyHandle^
A handle to an existing key.
- keyHandleOpenOptions
-
Type:
System.Security.Cryptography::CngKeyHandleOpenOptions
One of the enumeration values that indicates whether keyHandle represents an ephemeral key or a named key.
| Exception | Condition |
|---|---|
| ArgumentNullException | keyHandle is null. |
| ArgumentException | keyHandle is invalid or malformed, or it is already closed. This exception is also thrown if the key is an ephemeral key that is created by the common language runtime (CLR), but the EphemeralKey value is not specified. |
| PlatformNotSupportedException | Cryptography Next Generation (CNG) is not supported on this system. |
| CryptographicException | All other errors. |
This overload enables advanced users to use the CNG classes even if they rely on platform invoke or the managed interop capability of C++. For example, if you have a native library that returns the key as an NCRYPT_KEY_HANDLE, this overload lets you create a managed wrapper around the key and use the CNG classes to manipulate it.
When you open a key by using its handle, you cannot determine the key's ephemeral state and must specify it yourself. Several properties of the CngKey class rely on this value to be correct. Therefore, make sure that you pass the correct flag value to the Open methods.
for permission to call unmanaged code. Demand value: Demand. Associated enumeration: SecurityPermissionFlag::UnmanagedCode
Available since 3.5