CngKey.Open Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Tworzy wystąpienie CngKey obiektu reprezentującego istniejący klucz.

Przeciążenia

Open(String)	Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Tworzy wystąpienie CngKey obiektu przy użyciu uchwytu do istniejącego klucza.
Open(String, CngProvider)	Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz przy użyciu określonego dostawcy magazynu kluczy (KSP).
Open(String, CngProvider, CngKeyOpenOptions)	Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz przy użyciu określonego dostawcy magazynu kluczy (KSP) i opcji otwierania klucza.

Open(String)

Źródło:

Cng.NotSupported.cs

Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz.

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

Parametry

keyName

String

Nazwa klucza.

Zwraca

CngKey

Istniejący klucz.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

keyName to null.

PlatformNotSupportedException

Kryptografia Następnej generacji (CNG) nie jest obsługiwana w tym systemie.

CryptographicException

Wszystkie inne błędy.

Uwagi

To przeciążenie używa następujących wartości domyślnych:

• Dostawca magazynu kluczy (KSP): MicrosoftSoftwareKeyStorageProvider. Użyj przeciążenia, Open(String, CngProvider) jeśli chcesz określić inny program KSP.

• Kluczowe opcje otwierania: CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Źródło:

Cng.NotSupported.cs

Tworzy wystąpienie CngKey obiektu przy użyciu uchwytu do istniejącego klucza.

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

Parametry

keyHandle

SafeNCryptKeyHandle

Dojście do istniejącego klucza.

keyHandleOpenOptions

CngKeyHandleOpenOptions

Jedna z wartości wyliczenia wskazująca, czy keyHandle reprezentuje klucz efemeryczny, czy nazwany klucz.

Zwraca

CngKey

Istniejący klucz.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

keyHandle to null.

ArgumentException

keyHandle jest nieprawidłowy lub źle sformułowany lub jest już zamknięty. Ten wyjątek jest również zgłaszany, jeśli klucz jest kluczem efemerycznym utworzonym przez środowisko uruchomieniowe języka wspólnego (CLR), ale wartość nie jest określona EphemeralKey .

PlatformNotSupportedException

Kryptografia Następnej generacji (CNG) nie jest obsługiwana w tym systemie.

CryptographicException

Wszystkie inne błędy.

Uwagi

To przeciążenie umożliwia zaawansowanym użytkownikom korzystanie z klas CNG, nawet jeśli polegają na wywołaniu platformy lub zarządzanych możliwościach międzyoperacyjnych języka C++. Jeśli na przykład masz bibliotekę natywną, która zwraca klucz jako NCRYPT_KEY_HANDLE, to przeciążenie umożliwia utworzenie zarządzanej otoki wokół klucza i użycie klas CNG do manipulowania nim.

Po otwarciu klucza za pomocą uchwytu nie można określić stanu efemerycznego klucza i określić go samodzielnie. Kilka właściwości CngKey klasy polega na tej wartości, aby być poprawne. W związku z tym upewnij się, że do metod przekazano poprawną wartość flagi Open .

Open(String, CngProvider)

Źródło:

Cng.NotSupported.cs

Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz przy użyciu określonego dostawcy magazynu kluczy (KSP).

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

Parametry

keyName

String

Nazwa klucza.

provider

CngProvider

Dostawcy kluczy, który zawiera klucz.

Zwraca

CngKey

Istniejący klucz.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

keyName lub provider to null.

PlatformNotSupportedException

Kryptografia Następnej generacji (CNG) nie jest obsługiwana w tym systemie.

CryptographicException

Wszystkie inne błędy.

Uwagi

Open(String) W przeciwieństwie do przeciążenia metody to przeciążenie umożliwia określenie dostawcy. Ponadto tworzona jest wartość domyślna CngKeyOpenOptionsNone i powiązana z kluczem.

Open(String, CngProvider, CngKeyOpenOptions)

Źródło:

Cng.NotSupported.cs

Tworzy wystąpienie CngKey obiektu reprezentującego istniejący nazwany klucz przy użyciu określonego dostawcy magazynu kluczy (KSP) i opcji otwierania klucza.

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

Parametry

keyName

String

Nazwa klucza.

provider

CngProvider

Dostawcy kluczy, który zawiera klucz.

openOptions

CngKeyOpenOptions

Bitowa kombinacja wartości wyliczenia, które określają opcje otwierania klucza, takie jak miejsce otwarcia klucza (maszyna lub magazyn użytkownika) i czy pomijać monitowanie interfejsu użytkownika.

Zwraca

CngKey

Istniejący klucz.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

keyName lub provider to null.

PlatformNotSupportedException

Kryptografia Następnej generacji (CNG) nie jest obsługiwana w tym systemie.

CryptographicException

Wszystkie inne błędy.

Uwagi

Open(String) W przeciwieństwie do przeciążenia metody, to przeciążenie umożliwia określenie zarówno dostawcy, jak i kluczowych opcji otwierania.