CngKey.Open Methode

Definition

Namespace:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Security.Cryptography.Cng.dll

Assemblys:: System.Security.Cryptography.dll, System.Security.Cryptography.Cng.dll

Assembly:: System.Core.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
Open(String)	Erstellt eine Instanz eines CngKey Objekts, das einen vorhandenen benannten Schlüssel darstellt.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Erstellt eine Instanz eines CngKey Objekts mithilfe eines Handles für einen vorhandenen Schlüssel.
Open(String, CngProvider)	Erstellt eine Instanz eines CngKey Objekts, das einen vorhandenen benannten Schlüssel darstellt, mithilfe des angegebenen Schlüsselspeicheranbieters (Key Storage Provider, KSP).
Open(String, CngProvider, CngKeyOpenOptions)	Erstellt eine Instanz eines CngKey Objekts, das einen vorhandenen benannten Schlüssel darstellt, wobei der angegebene Schlüsselspeicheranbieter (Key Storage Provider, KSP) und die Optionen zum Öffnen von Schlüsseln verwendet werden.

Open(String)

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey Objekts, das 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);

public static System.Security.Cryptography.CngKey Open(string keyName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKey

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

Kryptografie der nächsten Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Diese Überladung verwendet die folgenden Standardwerte:

Schlüsselspeicheranbieter (KSP): MicrosoftSoftwareKeyStorageProvider. Verwenden Sie die Open(String, CngProvider) Überladung, wenn Sie einen anderen KSP angeben möchten.
Schlüssel geöffnete Optionen: CngKeyOpenOptions.None.

Gilt für:

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey Objekts mithilfe eines Handles für einen vorhandenen Schlüssel.

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);

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

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

Ein Handle zu einem vorhandenen Schlüssel.

keyHandleOpenOptions: CngKeyHandleOpenOptions

Einer der Enumerationswerte, der angibt, ob keyHandle ein kurzlebiger Schlüssel oder ein benannter Schlüssel dargestellt wird.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute: SupportedOSPlatformAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

keyHandle ist null.

ArgumentException

keyHandle ist ungültig oder falsch formatiert, oder sie ist bereits geschlossen. Diese Ausnahme wird auch ausgelöst, wenn der Schlüssel ein kurzlebiger Schlüssel ist, der von der Common Language Runtime (CLR) erstellt wird, aber der EphemeralKey Wert nicht angegeben wird.

PlatformNotSupportedException

Kryptografie der nächsten Generation (CNG) wird auf diesem System nicht unterstützt.

CryptographicException

Alle anderen Fehler.

Hinweise

Diese Überladung ermöglicht es erweiterten Benutzern, die CNG-Klassen zu verwenden, auch wenn sie sich auf den Plattform-Aufruf oder die verwaltete Interoperabilitätsfunktion von C++ verlassen. Wenn Sie beispielsweise über eine systemeigene 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 mithilfe des Handles öffnen, können Sie den kurzlebigen Zustand des Schlüssels nicht ermitteln und müssen ihn selbst angeben. Mehrere Eigenschaften der CngKey Klasse basieren auf diesem Wert, um korrekt zu sein. Stellen Sie daher sicher, dass Sie den richtigen Flagwert an die Open Methoden übergeben.

Gilt für:

Open(String, CngProvider)

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey Objekts, das einen vorhandenen benannten Schlüssel darstellt, mithilfe des angegebenen Schlüsselspeicheranbieters (Key Storage Provider, 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);

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

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

Kryptografie der nächsten 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 None erstellt und an den Schlüssel gebunden.

Gilt für:

Open(String, CngProvider, CngKeyOpenOptions)

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Erstellt eine Instanz eines CngKey Objekts, das einen vorhandenen benannten Schlüssel darstellt, wobei der angegebene Schlüsselspeicheranbieter (Key Storage Provider, KSP) und die Optionen zum Öffnen von Schlüsseln 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);

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

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

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. wo der Schlüssel geöffnet wird (Computer oder Benutzerspeicher), und ob die Benutzeroberflächenaufforderung unterdrückt werden soll.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.

Attribute: SupportedOSPlatformAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

keyName oder provider ist null.

PlatformNotSupportedException

Kryptografie der nächsten 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 den Anbieter als auch die Optionen zum Öffnen des Schlüssels angeben.

Gilt für:

Feedback

War diese Seite hilfreich?