CngKey.Open Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

System.Security.Cryptography.dll

Vytvoří instanci objektu CngKey , který představuje existující klíč.

Přetížení

Open(String)	Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Vytvoří instanci objektu CngKey pomocí popisovače existujícího klíče.
Open(String, CngProvider)	Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč pomocí zadaného poskytovatele úložiště klíčů (KSP).
Open(String, CngProvider, CngKeyOpenOptions)	Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč pomocí zadaného poskytovatele úložiště klíčů (KSP) a možností otevření klíče.

Open(String)

Zdroj:

Cng.NotSupported.cs

Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč.

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

Název klíče.

Návraty

CngKey

Existující klíč.

Atributy

SupportedOSPlatformAttribute

Výjimky

ArgumentNullException

keyName je null.

PlatformNotSupportedException

Kryptografie další generace (CNG) není v tomto systému podporována.

CryptographicException

Všechny ostatní chyby.

Poznámky

Toto přetížení používá následující výchozí hodnoty:

• Zprostředkovatel úložiště klíčů (KSP): MicrosoftSoftwareKeyStorageProvider. Open(String, CngProvider) Pokud chcete zadat jiný KSP, použijte přetížení.

• Možnosti otevření klíče: CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Zdroj:

Cng.NotSupported.cs

Vytvoří instanci objektu CngKey pomocí popisovače existujícího klíče.

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

Popisovač existujícího klíče.

keyHandleOpenOptions

CngKeyHandleOpenOptions

Jedna z hodnot výčtu, která označuje, zda keyHandle představuje dočasný klíč nebo pojmenovaný klíč.

Návraty

CngKey

Existující klíč.

Atributy

SupportedOSPlatformAttribute

Výjimky

ArgumentNullException

keyHandle je null.

ArgumentException

keyHandle je neplatný nebo poškozený nebo je již zavřený. Tato výjimka se vyvolá také v případě, že je klíč dočasným klíčem vytvořeným modulem CLR (Common Language Runtime), ale EphemeralKey hodnota není zadaná.

PlatformNotSupportedException

Kryptografie další generace (CNG) není v tomto systému podporována.

CryptographicException

Všechny ostatní chyby.

Poznámky

Toto přetížení umožňuje pokročilým uživatelům používat třídy CNG i v případě, že se spoléhají na volání platformy nebo schopnost spravované zprostředkovatele komunikace jazyka C++. Pokud máte například nativní knihovnu, která vrací klíč jako NCRYPT_KEY_HANDLE, toto přetížení vám umožní vytvořit kolem klíče spravovanou obálku a používat třídy CNG k manipulaci s ním.

Když otevřete klíč pomocí jeho popisovače, nemůžete určit dočasný stav klíče a musíte ho zadat sami. Několik vlastností CngKey třídy závisí na této hodnotě, aby byla správná. Proto se ujistěte, že metody předáte správnou hodnotu příznaku Open .

Open(String, CngProvider)

Zdroj:

Cng.NotSupported.cs

Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč pomocí zadaného poskytovatele úložiště klíčů (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

Název klíče.

provider

CngProvider

KSP, který obsahuje klíč.

Návraty

CngKey

Existující klíč.

Atributy

SupportedOSPlatformAttribute

Výjimky

ArgumentNullException

keyName nebo provider je null.

PlatformNotSupportedException

Kryptografie další generace (CNG) není v tomto systému podporována.

CryptographicException

Všechny ostatní chyby.

Poznámky

Open(String) Na rozdíl od přetížení metody toto přetížení umožňuje určit zprostředkovatele. Kromě toho se vytvoří výchozí CngKeyOpenOptions hodnota None a je vázána na klíč.

Open(String, CngProvider, CngKeyOpenOptions)

Zdroj:

Cng.NotSupported.cs

Vytvoří instanci objektu CngKey , který představuje existující pojmenovaný klíč pomocí zadaného poskytovatele úložiště klíčů (KSP) a možností otevření klíče.

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

Název klíče.

provider

CngProvider

KSP, který obsahuje klíč.

openOptions

CngKeyOpenOptions

Bitové kombinace hodnot výčtu, které určují možnosti pro otevření klíče, například odkud je klíč otevřen (počítač nebo uživatelské úložiště) a zda se mají potlačit výzvy uživatelského rozhraní.

Návraty

CngKey

Existující klíč.

Atributy

SupportedOSPlatformAttribute

Výjimky

ArgumentNullException

keyName nebo provider je null.

PlatformNotSupportedException

Kryptografie další generace (CNG) není v tomto systému podporována.

CryptographicException

Všechny ostatní chyby.

Poznámky

Open(String) Na rozdíl od přetížení metody toto přetížení umožňuje určit jak zprostředkovatele, tak možnosti otevření klíče.