CngKey.Open Methode

Definition

Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen Schlüssel darstellt.Creates an instance of an CngKey object that represents an existing key.

Überlädt

Open(String)

Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen benannten Schlüssel darstellt.Creates an instance of an CngKey object that represents an existing named key.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Erstellt unter Verwendung eines Handles für einen vorhandenen Schlüssel eine Instanz eines CngKey-Objekts.Creates an instance of an CngKey object by using a handle to an existing key.

Open(String, CngProvider)

Erstellt unter Verwendung des angegebenen Schlüsselspeicheranbieters (KSP) eine Instanz eines CngKey-Objekts, das einen vorhandenen benannten Schlüssel darstellt.Creates an instance of an CngKey object that represents an existing named key, using the specified 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 (KSP) und die angegebenen Optionen für das Öffnen eines Schlüssels verwendet werden.Creates an instance of an CngKey object that represents an existing named key, using the specified key storage provider (KSP) and key open options.

Open(String)

Erstellt eine Instanz eines CngKey-Objekts, die einen vorhandenen benannten Schlüssel darstellt.Creates an instance of an CngKey object that represents an existing named key.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);
public static System.Security.Cryptography.CngKey Open (string keyName);
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.The name of the key.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.An existing key.

Ausnahmen

keyName ist null.keyName is null.

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.Cryptography Next Generation (CNG) is not supported on this system.

Alle anderen Fehler.All other errors.

Hinweise

Diese Überladung verwendet die folgenden Standardwerte:This overload uses the following defaults:

Gilt für:

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Erstellt unter Verwendung eines Handles für einen vorhandenen Schlüssel eine Instanz eines CngKey-Objekts.Creates an instance of an CngKey object by using a handle to an existing key.

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);
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.A handle to an existing key.

keyHandleOpenOptions
CngKeyHandleOpenOptions

Einer der Enumerationswerte, die angeben, ob keyHandle einen flüchtigen Schlüssel oder einen benannten Schlüssel darstellt.One of the enumeration values that indicates whether keyHandle represents an ephemeral key or a named key.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.An existing key.

Attribute

Ausnahmen

keyHandle ist null.keyHandle is null.

keyHandle ist ungültig oder fehlerhaft, oder es wurde bereits geschlossen.keyHandle is invalid or malformed, or it is already closed. 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.This exception is also thrown if the key is an ephemeral key that is created by the common language runtime (CLR), but the EphemeralKey value is not specified.

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.Cryptography Next Generation (CNG) is not supported on this system.

Alle anderen Fehler.All other errors.

Hinweise

Diese Überladung ermöglicht es fortgeschrittenen Benutzern, die CNG-Klassen auch dann zu verwenden, wenn Sie den Platt Form Aufruf oder die verwaltete Interop-Funktion von C++ verwenden.This overload enables advanced users to use the CNG classes even if they rely on platform invoke or the managed interop capability of C++. Wenn Sie z. b. ü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.For example, if you have a native library that returns the key as an NCRYPT_KEY_HANDLE, this overload lets you create a managed wrapper around the key and use the CNG classes to manipulate it.

Wenn Sie einen Schlüssel mithilfe seines Handles öffnen, können Sie den kurzlebigen Zustand des Schlüssels nicht ermitteln und müssen ihn selbst angeben.When you open a key by using its handle, you cannot determine the key's ephemeral state and must specify it yourself. Mehrere Eigenschaften der- CngKey Klasse basieren darauf, dass dieser Wert korrekt ist.Several properties of the CngKey class rely on this value to be correct. Stellen Sie daher sicher, dass Sie den korrekten Flagwert an die- Open Methoden übergeben.Therefore, make sure that you pass the correct flag value to the Open methods.

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.Creates an instance of an CngKey object that represents an existing named key, using the specified key storage provider (KSP).

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);
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.The name of the key.

provider
CngProvider

Der KSP, der den Schlüssel enthält.The KSP that contains the key.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.An existing key.

Ausnahmen

keyName oder provider ist null.keyName or provider is null.

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.Cryptography Next Generation (CNG) is not supported on this system.

Alle anderen Fehler.All other errors.

Hinweise

Anders als bei der- Open(String) Methoden Überladung können Sie mit dieser Überladung den Anbieter angeben.Unlike the Open(String) method overload, this overload lets you specify the provider. Außerdem wird ein Standard CngKeyOpenOptions Wert von None erstellt und an den Schlüssel gebunden.In addition, a default CngKeyOpenOptions value of None is created and bound to the key.

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.Creates an instance of an CngKey object that represents an existing named key, using the specified key storage provider (KSP) and key open options.

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.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.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.The name of the key.

provider
CngProvider

Der KSP, der den Schlüssel enthält.The KSP that contains the key.

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.A bitwise combination of the enumeration values that specify options for opening the key, such as where the key is opened from (machine or user storage) and whether to suppress UI prompting.

Gibt zurück

CngKey

Ein vorhandener Schlüssel.An existing key.

Attribute

Ausnahmen

keyName oder provider ist null.keyName or provider is null.

Cryptography Next Generation (CNG) wird auf diesem System nicht unterstützt.Cryptography Next Generation (CNG) is not supported on this system.

Alle anderen Fehler.All other errors.

Hinweise

Anders als bei der- Open(String) Methoden Überladung können Sie mit dieser Überladung sowohl den Anbieter als auch die Optionen zum Öffnen des Schlüssels angeben.Unlike the Open(String) method overload, this overload lets you specify both the provider and the key open options.

Gilt für: