CngKey.Open 方法

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

创建表示现有密钥的 CngKey 对象的一个实例。

重载

Open(String)	创建表示现有已命名密钥的 CngKey 对象的一个实例。
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	使用现有密钥的句柄创建 CngKey 对象的一个实例。
Open(String, CngProvider)	使用指定的密钥存储提供程序 (KSP)，创建表示现有已命名密钥的 CngKey 对象的一个实例。
Open(String, CngProvider, CngKeyOpenOptions)	使用指定的密钥存储提供程序 (KSP) 和密钥打开选项，创建表示现有已命名密钥的 CngKey 对象的一个实例。

Open(String)

Source:

Cng.NotSupported.cs

创建表示现有已命名密钥的 CngKey 对象的一个实例。

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String) As CngKey

参数

keyName

String

键的名称。

返回

CngKey

现有密钥。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

keyName 为 null。

PlatformNotSupportedException

此系统上不支持下一代加密技术 (CNG)。

CryptographicException

所有其他错误。

注解

此重载使用以下默认值：

• 密钥存储提供程序 (KSP) ： MicrosoftSoftwareKeyStorageProvider。 如果要指定其他 KSP， Open(String, CngProvider) 请使用 重载。

• 键打开选项： CngKeyOpenOptions.None。

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Source:

Cng.NotSupported.cs

使用现有密钥的句柄创建 CngKey 对象的一个实例。

public:
 static System::Security::Cryptography::CngKey ^ Open(Microsoft::Win32::SafeHandles::SafeNCryptKeyHandle ^ keyHandle, System::Security::Cryptography::CngKeyHandleOpenOptions keyHandleOpenOptions);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyHandle As SafeNCryptKeyHandle, keyHandleOpenOptions As CngKeyHandleOpenOptions) As CngKey

参数

keyHandle

SafeNCryptKeyHandle

现有密钥的句柄。

keyHandleOpenOptions

CngKeyHandleOpenOptions

指示 keyHandle 是否表示暂时密钥或已命名密钥的枚举值之一。

返回

CngKey

现有密钥。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

keyHandle 为 null。

ArgumentException

keyHandle 无效或格式不正确或已经被关闭。 如果密钥是由公共语言运行时 (CLR) 创建的暂时密钥，但未指定 EphemeralKey 值，也会引发此异常。

PlatformNotSupportedException

此系统上不支持下一代加密技术 (CNG)。

CryptographicException

所有其他错误。

注解

此重载使高级用户能够使用 CNG 类，即使他们依赖于平台调用或 C++ 的托管互操作功能。 例如，如果你有一个以NCRYPT_KEY_HANDLE的形式返回密钥的本机库，则此重载允许你围绕密钥创建托管包装器，并使用 CNG 类对其进行操作。

使用句柄打开密钥时，无法确定密钥的临时状态，必须自行指定。 类的 CngKey 多个属性依赖于此值是正确的。 因此，请确保将正确的标志值传递给 Open 方法。

Open(String, CngProvider)

Source:

Cng.NotSupported.cs

使用指定的密钥存储提供程序 (KSP)，创建表示现有已命名密钥的 CngKey 对象的一个实例。

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider) As CngKey

参数

keyName

String

键的名称。

provider

CngProvider

包含密钥的 KSP。

返回

CngKey

现有密钥。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

keyName 或 provider 为 null。

PlatformNotSupportedException

此系统上不支持下一代加密技术 (CNG)。

CryptographicException

所有其他错误。

注解

Open(String)与方法重载不同，此重载允许指定提供程序。 此外，将创建默认值 CngKeyOpenOptionsNone 并将其绑定到键。

Open(String, CngProvider, CngKeyOpenOptions)

Source:

Cng.NotSupported.cs

使用指定的密钥存储提供程序 (KSP) 和密钥打开选项，创建表示现有已命名密钥的 CngKey 对象的一个实例。

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider, System::Security::Cryptography::CngKeyOpenOptions openOptions);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider, openOptions As CngKeyOpenOptions) As CngKey

参数

keyName

String

键的名称。

provider

CngProvider

包含密钥的 KSP。

openOptions

CngKeyOpenOptions

枚举值的一个按位组合，这些值指定打开密钥的选项，例如打开密钥的位置（计算机或用户存储）以及是否取消 UI 提示。

返回

CngKey

现有密钥。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

keyName 或 provider 为 null。

PlatformNotSupportedException

此系统上不支持下一代加密技术 (CNG)。

CryptographicException

所有其他错误。

注解

Open(String)与方法重载不同，此重载允许指定提供程序和键打开选项。