CngKey.Open Methode

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen Schlüssel darstellt.

Überlädt

Open(String)	Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen benannten Schlüssel darstellt.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Erstellt unter Verwendung eines Handles für einen vorhandenen Schlüssel eine Instanz eines CngKey-Objekts.
Open(String, CngProvider)	Erstellt unter Verwendung des angegebenen Schlüsselspeicheranbieters (KSP) eine Instanz eines CngKey-Objekts, das einen vorhandenen benannten Schlüssel darstellt.
Open(String, CngProvider, CngKeyOpenOptions)	Erstellt eine Instanz eines CngKey-Objekts, das einen vorhandenen benannten Schlüssel darstellt, wobei der angegebene Schlüsselspeicheranbieter (KSP) und die angegebenen Optionen für das Öffnen eines Schlüssels verwendet werden.

Open(String)

Quelle:

Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen benannten Schlüssel darstellt.

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

Der Name des Schlüssels.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

keyName ist null.

PlatformNotSupportedException

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Diese Überladung verwendet die folgenden Standardwerte:

• Schlüsselspeicheranbieter (Key Storage Provider, KSP): MicrosoftSoftwareKeyStorageProvider. Verwenden Sie die Open(String, CngProvider) Überladung, wenn Sie einen anderen KSP angeben möchten.

• Optionen zum Öffnen des Schlüssels: CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Quelle:

Cng.NotSupported.cs

Erstellt unter Verwendung eines Handles für einen vorhandenen Schlüssel eine Instanz eines CngKey-Objekts.

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

Ein Handle für einen vorhandenen Schlüssel.

keyHandleOpenOptions

CngKeyHandleOpenOptions

Einer der Enumerationswerte, die angeben, ob keyHandle einen flüchtigen Schlüssel oder einen benannten Schlüssel darstellt.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

keyHandle ist null.

ArgumentException

keyHandle ist ungültig oder fehlerhaft, oder es wurde bereits geschlossen. Diese Ausnahme wird auch ausgelöst, wenn es sich um einen flüchtigen Schlüssel handelt, der von der Common Language Runtime (CLR) erstellt wird, und der EphemeralKey-Wert nicht angegeben ist.

PlatformNotSupportedException

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Diese Überladung ermöglicht es erweiterten Benutzern, die CNG-Klassen auch dann zu verwenden, wenn sie vom Plattformaufruf oder der verwalteten Interopfunktion von C++ abhängig sind. Wenn Sie beispielsweise über eine native Bibliothek verfügen, die den Schlüssel als NCRYPT_KEY_HANDLE zurückgibt, können Sie mit dieser Überladung einen verwalteten Wrapper um den Schlüssel erstellen und die CNG-Klassen verwenden, um ihn zu bearbeiten.

Wenn Sie einen Schlüssel mit seinem Handle öffnen, können Sie den kurzlebigen Zustand des Schlüssels nicht bestimmen und müssen ihn selbst angeben. Mehrere Eigenschaften der CngKey -Klasse basieren darauf, dass dieser Wert richtig ist. Stellen Sie daher sicher, dass Sie den richtigen Flagwert an die Open Methoden übergeben.

Open(String, CngProvider)

Quelle:

Cng.NotSupported.cs

Erstellt unter Verwendung des angegebenen Schlüsselspeicheranbieters (KSP) eine Instanz eines CngKey-Objekts, das einen vorhandenen benannten Schlüssel darstellt.

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

Der Name des Schlüssels.

provider

CngProvider

Der KSP, der den Schlüssel enthält.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

keyName oder provider ist null.

PlatformNotSupportedException

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Open(String) Im Gegensatz zur Methodenüberladung können Sie mit dieser Überladung den Anbieter angeben. Darüber hinaus wird ein Standardwert CngKeyOpenOptions von None erstellt und an den Schlüssel gebunden.

Open(String, CngProvider, CngKeyOpenOptions)

Quelle:

Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey-Objekts, das einen vorhandenen benannten Schlüssel darstellt, wobei der angegebene Schlüsselspeicheranbieter (KSP) und die angegebenen Optionen für das Öffnen eines Schlüssels verwendet werden.

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

Der Name des Schlüssels.

provider

CngProvider

Der KSP, der den Schlüssel enthält.

openOptions

CngKeyOpenOptions

Eine bitweise Kombination der Enumerationswerte, die Optionen zum Öffnen des Schlüssels angeben, z.B. Informationen dazu, wo der Schlüssel geöffnet wurde (Computer- oder Benutzerspeicher) und ob Aufforderungen auf der Benutzeroberfläche unterdrückt werden sollen.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

keyName oder provider ist null.

PlatformNotSupportedException

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Open(String) Im Gegensatz zur Methodenüberladung können Sie mit dieser Überladung sowohl die Optionen zum Öffnen des Anbieters als auch den Schlüssel angeben.