Partage via


CngKey.Open Méthode

Définition

Crée une instance d'un objet CngKey qui représente une clé existante.

Surcharges

Open(String)

Crée une instance d'un objet CngKey qui représente une clé nommée existante.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Crée une instance d'un objet CngKey en utilisant un handle pour une clé existante.

Open(String, CngProvider)

Crée une instance d'un objet CngKey qui représente une clé nommée existante, à l'aide du fournisseur de stockage de clés (KSP) spécifié.

Open(String, CngProvider, CngKeyOpenOptions)

Crée une instance d'un objet CngKey qui représente une clé nommée existante, à l'aide du fournisseur de stockage de clés (KSP) et des options d'ouverture de clé spécifiées.

Open(String)

Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs

Crée une instance d'un objet CngKey qui représente une clé nommée existante.

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

Paramètres

keyName
String

Nom de la clé.

Retours

Clé existante.

Attributs

Exceptions

keyName a la valeur null.

CNG (Cryptography Next Generation) n’est pas pris en charge sur ce système.

Toutes les autres erreurs.

Remarques

Cette surcharge utilise les valeurs par défaut suivantes :

S’applique à

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs

Crée une instance d'un objet CngKey en utilisant un handle pour une clé existante.

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

Paramètres

keyHandle
SafeNCryptKeyHandle

Handle d'une clé existante.

keyHandleOpenOptions
CngKeyHandleOpenOptions

Valeur de l'énumération (parmi d'autres) qui indique si keyHandle représente une clé éphémère ou une clé nommée.

Retours

Clé existante.

Attributs

Exceptions

keyHandle a la valeur null.

keyHandle n'est pas valide ou est incorrect, ou est déjà fermé. Cette exception est également levée si la clé est une clé éphémère créée par le langage CLR (common language runtime), mais que la valeur EphemeralKey n'est pas spécifiée.

CNG (Cryptography Next Generation) n’est pas pris en charge sur ce système.

Toutes les autres erreurs.

Remarques

Cette surcharge permet aux utilisateurs avancés d’utiliser les classes CNG même s’ils s’appuient sur l’appel de plateforme ou la fonctionnalité d’interopérabilité managée de C++. Par exemple, si vous avez une bibliothèque native qui retourne la clé en tant que NCRYPT_KEY_HANDLE, cette surcharge vous permet de créer un wrapper managé autour de la clé et d’utiliser les classes CNG pour la manipuler.

Lorsque vous ouvrez une clé à l’aide de son handle, vous ne pouvez pas déterminer l’état éphémère de la clé et vous devez le spécifier vous-même. Plusieurs propriétés de la classe s’appuient CngKey sur cette valeur pour être correctes. Par conséquent, assurez-vous que vous transmettez la valeur d’indicateur correcte aux Open méthodes.

S’applique à

Open(String, CngProvider)

Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs

Crée une instance d'un objet CngKey qui représente une clé nommée existante, à l'aide du fournisseur de stockage de clés (KSP) spécifié.

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

Paramètres

keyName
String

Nom de la clé.

provider
CngProvider

Le fournisseur de stockage de clés qui contient la clé.

Retours

Clé existante.

Attributs

Exceptions

keyName ou provider est null.

CNG (Cryptography Next Generation) n’est pas pris en charge sur ce système.

Toutes les autres erreurs.

Remarques

Contrairement à la surcharge de Open(String) méthode, cette surcharge vous permet de spécifier le fournisseur. En outre, une valeur par défaut CngKeyOpenOptions de None est créée et liée à la clé.

S’applique à

Open(String, CngProvider, CngKeyOpenOptions)

Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs
Source:
Cng.NotSupported.cs

Crée une instance d'un objet CngKey qui représente une clé nommée existante, à l'aide du fournisseur de stockage de clés (KSP) et des options d'ouverture de clé spécifiées.

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

Paramètres

keyName
String

Nom de la clé.

provider
CngProvider

Le fournisseur de stockage de clés qui contient la clé.

openOptions
CngKeyOpenOptions

Combinaison de bits des valeurs d’énumération qui spécifient des options d’ouverture de la clé, par exemple d’où la clé est ouverte (stockage de machine ou utilisateur) et s’il faut supprimer l’invite de l’interface utilisateur.

Retours

Clé existante.

Attributs

Exceptions

keyName ou provider est null.

CNG (Cryptography Next Generation) n’est pas pris en charge sur ce système.

Toutes les autres erreurs.

Remarques

Contrairement à la surcharge de Open(String) méthode, cette surcharge vous permet de spécifier à la fois le fournisseur et les options d’ouverture de clé.

S’applique à