CngKey.Open Metode

Definisi

Ruang nama:

System.Security.Cryptography

Rakitan:

System.Security.Cryptography.dll

Membuat instans CngKey objek yang mewakili kunci yang ada.

Overload

Open(String)	Membuat instans CngKey objek yang mewakili kunci bernama yang sudah ada.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Membuat instans CngKey objek dengan menggunakan handel ke kunci yang ada.
Open(String, CngProvider)	Membuat instans CngKey objek yang mewakili kunci bernama yang ada, menggunakan penyedia penyimpanan kunci (KSP) yang ditentukan.
Open(String, CngProvider, CngKeyOpenOptions)	Membuat instans CngKey objek yang mewakili kunci bernama yang ada, menggunakan penyedia penyimpanan kunci (KSP) yang ditentukan dan opsi buka kunci.

Open(String)

Sumber:

Cng.NotSupported.cs

Membuat instans CngKey objek yang mewakili kunci bernama yang sudah ada.

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

Parameter

keyName

String

Nama kunci.

Mengembalikan

CngKey

Kunci yang ada.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentNullException

keyNameadalah null.

PlatformNotSupportedException

Kriptografi Next Generation (CNG) tidak didukung pada sistem ini.

CryptographicException

Semua kesalahan lainnya.

Keterangan

Kelebihan beban ini menggunakan default berikut:

• Penyedia penyimpanan utama (KSP): MicrosoftSoftwareKeyStorageProvider. Open(String, CngProvider) Gunakan kelebihan beban jika Anda ingin menentukan KSP lain.

• Opsi buka kunci: CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Sumber:

Cng.NotSupported.cs

Membuat instans CngKey objek dengan menggunakan handel ke kunci yang ada.

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

Parameter

keyHandle

SafeNCryptKeyHandle

Handel ke kunci yang ada.

keyHandleOpenOptions

CngKeyHandleOpenOptions

Salah satu nilai enumerasi yang menunjukkan apakah keyHandle mewakili kunci ephemeral atau kunci bernama.

Mengembalikan

CngKey

Kunci yang ada.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentNullException

keyHandleadalah null.

ArgumentException

keyHandle tidak valid atau cacat, atau sudah ditutup. Pengecualian ini juga dilemparkan jika kunci adalah kunci sementara yang dibuat oleh runtime bahasa umum (CLR), tetapi EphemeralKey nilainya tidak ditentukan.

PlatformNotSupportedException

Kriptografi Next Generation (CNG) tidak didukung pada sistem ini.

CryptographicException

Semua kesalahan lainnya.

Keterangan

Kelebihan beban ini memungkinkan pengguna tingkat lanjut untuk menggunakan kelas CNG meskipun mereka mengandalkan pemanggilan platform atau kemampuan interop terkelola C++. Misalnya, jika Anda memiliki pustaka asli yang mengembalikan kunci sebagai NCRYPT_KEY_HANDLE, kelebihan beban ini memungkinkan Anda membuat pembungkus terkelola di sekitar kunci dan menggunakan kelas CNG untuk memanipulasinya.

Saat Anda membuka kunci dengan menggunakan handelnya, Anda tidak dapat menentukan status sementara kunci dan harus menentukannya sendiri. Beberapa properti kelas mengandalkan CngKey nilai ini agar benar. Oleh karena itu, pastikan Anda meneruskan nilai bendera yang benar ke Open metode .

Open(String, CngProvider)

Sumber:

Cng.NotSupported.cs

Membuat instans CngKey objek yang mewakili kunci bernama yang ada, menggunakan penyedia penyimpanan kunci (KSP) yang ditentukan.

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

Parameter

keyName

String

Nama kunci.

provider

CngProvider

KSP yang berisi kunci.

Mengembalikan

CngKey

Kunci yang ada.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentNullException

keyName atau provider adalah null.

PlatformNotSupportedException

Kriptografi Next Generation (CNG) tidak didukung pada sistem ini.

CryptographicException

Semua kesalahan lainnya.

Keterangan

Open(String) Tidak seperti metode kelebihan beban, kelebihan beban ini memungkinkan Anda menentukan penyedia. Selain itu, nilai None default CngKeyOpenOptions dibuat dan terikat ke kunci.

Open(String, CngProvider, CngKeyOpenOptions)

Sumber:

Cng.NotSupported.cs

Membuat instans CngKey objek yang mewakili kunci bernama yang ada, menggunakan penyedia penyimpanan kunci (KSP) yang ditentukan dan opsi buka kunci.

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

Parameter

keyName

String

Nama kunci.

provider

CngProvider

KSP yang berisi kunci.

openOptions

CngKeyOpenOptions

Kombinasi bitwise dari nilai enumerasi yang menentukan opsi untuk membuka kunci, seperti dari mana kunci dibuka (penyimpanan mesin atau pengguna) dan apakah akan menekan permintaan UI.

Mengembalikan

CngKey

Kunci yang ada.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentNullException

keyName atau provider adalah null.

PlatformNotSupportedException

Kriptografi Next Generation (CNG) tidak didukung pada sistem ini.

CryptographicException

Semua kesalahan lainnya.

Keterangan

Open(String) Tidak seperti metode kelebihan beban, kelebihan beban ini memungkinkan Anda menentukan penyedia dan opsi buka kunci.