Share via


CngKey.Open Methode

Definition

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
Quelle:
Cng.NotSupported.cs
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);
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

Der Name des Schlüssels.

Gibt zurück

Ein vorhandener Schlüssel.

Attribute

Ausnahmen

keyName ist null.

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

Alle anderen Fehler.

Hinweise

Diese Überladung verwendet die folgenden Standardwerte:

Gilt für:

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Quelle:
Cng.NotSupported.cs
Quelle:
Cng.NotSupported.cs
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);
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

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

Ein vorhandener Schlüssel.

Attribute

Ausnahmen

keyHandle ist null.

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.

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

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.

Gilt für:

Open(String, CngProvider)

Quelle:
Cng.NotSupported.cs
Quelle:
Cng.NotSupported.cs
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);
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

Der Name des Schlüssels.

provider
CngProvider

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

Gibt zurück

Ein vorhandener Schlüssel.

Attribute

Ausnahmen

keyName oder provider ist null.

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

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.

Gilt für:

Open(String, CngProvider, CngKeyOpenOptions)

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

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

Ein vorhandener Schlüssel.

Attribute

Ausnahmen

keyName oder provider ist null.

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

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.

Gilt für: