CngKey.Open Méthode

Référence

Définition

Espace de noms:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Cng.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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)

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

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.

S’applique à

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

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

CngKey

Clé existante.

Attributs: SupportedOSPlatformAttribute SecurityCriticalAttribute

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 sur 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 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)

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

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 Open(String) surcharge de méthode, cette surcharge vous permet de spécifier le fournisseur. En outre, une valeur par défaut CngKeyOpenOptions est None créée et liée à la clé.

S’applique à

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.

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

CngKey

Clé existante.

Attributs: SupportedOSPlatformAttribute SecurityCriticalAttribute

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 méthode Open(String) , cette surcharge vous permet de spécifier le fournisseur et les options d’ouverture de clé.

S’applique à

CngKey.Open Méthode

Définition

Surcharges

Open(String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Open(String, CngProvider)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Open(String, CngProvider, CngKeyOpenOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires