CngKey.Open Methode
Definition
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, 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)
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.CngKeyPublic Shared Function Open (keyName As String) As CngKeyParameter
- 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:
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)
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.CngKeyPublic Shared Function Open (keyHandle As SafeNCryptKeyHandle, keyHandleOpenOptions As CngKeyHandleOpenOptions) As CngKeyParameter
- 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
Mit dieser Überladung können erweiterte Benutzer die CNG-Klassen auch dann verwenden, wenn sie sich auf Plattformaufrufe oder die verwaltete Interopfunktion 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 ephemeren Zustand des Schlüssels nicht ermitteln und selbst angeben. Mehrere Eigenschaften der CngKey Klasse basieren auf diesem Wert, um richtig zu sein. Stellen Sie daher sicher, dass Sie den richtigen Flagwert an die Open Methoden übergeben.
Gilt für
Open(String, CngProvider)
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.CngKeyPublic Shared Function Open (keyName As String, provider As CngProvider) As CngKeyParameter
- 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
Im Gegensatz zu der Open(String) Methodenüberladung können Sie 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)
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.CngKeyPublic Shared Function Open (keyName As String, provider As CngProvider, openOptions As CngKeyOpenOptions) As CngKeyParameter
- 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
Im Gegensatz zu der Open(String) Methodenüberladung können Sie sowohl den Anbieter als auch die Schlüssel geöffneten Optionen angeben.