CngKey.Open Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

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

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

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName);

Paramètres

keyName

String

Nom de la clé.

Retours

CngKey

Clé existante.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentNullException

keyName a la valeur null.

PlatformNotSupportedException

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

CryptographicException

Toutes les autres erreurs.

Remarques

Cette surcharge utilise les valeurs par défaut suivantes :

• Fournisseur de stockage de clés (KSP) : MicrosoftSoftwareKeyStorageProvider. Utilisez la Open(String, CngProvider) surcharge si vous souhaitez spécifier un autre KSP.

• Options d’ouverture de clé : CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Source:

Cng.NotSupported.cs

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

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);

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

CngKey

Clé existante.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentNullException

keyHandle a la valeur null.

ArgumentException

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.

PlatformNotSupportedException

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

CryptographicException

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.

Open(String, CngProvider)

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é.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider);

Paramètres

keyName

String

Nom de la clé.

provider

CngProvider

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

Retours

CngKey

Clé existante.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentNullException

keyName ou provider est null.

PlatformNotSupportedException

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

CryptographicException

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é.

Open(String, CngProvider, CngKeyOpenOptions)

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.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);

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

CngKey

Clé existante.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentNullException

keyName ou provider est null.

PlatformNotSupportedException

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

CryptographicException

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é.