Bagikan melalui


CngKey.Open Metode

Definisi

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
Sumber:
Cng.NotSupported.cs
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);
public static System.Security.Cryptography.CngKey Open (string keyName);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName);
static member Open : string -> System.Security.Cryptography.CngKey
[<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

Kunci yang ada.

Atribut

Pengecualian

keyNameadalah null.

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

Semua kesalahan lainnya.

Keterangan

Kelebihan beban ini menggunakan default berikut:

Berlaku untuk

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Sumber:
Cng.NotSupported.cs
Sumber:
Cng.NotSupported.cs
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);
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.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey
[<System.Security.SecurityCritical>]
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

Kunci yang ada.

Atribut

Pengecualian

keyHandleadalah null.

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.

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

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 .

Berlaku untuk

Open(String, CngProvider)

Sumber:
Cng.NotSupported.cs
Sumber:
Cng.NotSupported.cs
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);
public static System.Security.Cryptography.CngKey Open (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);
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey
[<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

Kunci yang ada.

Atribut

Pengecualian

keyName atau provider adalah null.

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

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.

Berlaku untuk

Open(String, CngProvider, CngKeyOpenOptions)

Sumber:
Cng.NotSupported.cs
Sumber:
Cng.NotSupported.cs
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);
public static System.Security.Cryptography.CngKey Open (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.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey
[<System.Security.SecurityCritical>]
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

Kunci yang ada.

Atribut

Pengecualian

keyName atau provider adalah null.

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

Semua kesalahan lainnya.

Keterangan

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

Berlaku untuk