CngKey.Open Méthode

Définition

Espace de noms:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.dll

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

Assemblys:: System.Security.Cryptography.dll, System.Security.Cryptography.Cng.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 CngKey objet qui représente une clé existante.

Surcharges

Nom	Description
Open(String)	Crée une instance d’un CngKey objet qui représente une clé nommée existante.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Crée une instance d’un CngKey objet à l’aide d’un handle vers une clé existante.
Open(String, CngProvider)	Crée une instance d’un CngKey objet 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 CngKey objet qui représente une clé nommée existante, à l’aide du fournisseur de stockage de clés spécifié (KSP) et des options d’ouverture de clé.

Open(String)

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

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

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);

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

public static System.Security.Cryptography.CngKey Open(string keyName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKey

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

Le chiffrement de nouvelle génération (CNG) 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)

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Crée une instance d’un CngKey objet à l’aide d’un handle vers une clé existante.

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

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

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 vers une clé existante.

keyHandleOpenOptions: CngKeyHandleOpenOptions

Une des valeurs d’énumération qui indique s’il keyHandle s’agit d’une clé éphémère ou d’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 mal formé ou est déjà fermé. Cette exception est également levée si la clé est une clé éphémère créée par le Common Language Runtime (CLR), mais que la EphemeralKey valeur n’est pas spécifiée.

PlatformNotSupportedException

Le chiffrement de nouvelle génération (CNG) 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 si elles 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 les 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 CngKey classe s’appuient sur cette valeur pour être correctes. Par conséquent, veillez à passer 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

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Crée une instance d’un CngKey objet 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);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open(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")>]
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey

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

KSP qui contient la clé.

Retours

CngKey

Clé existante.

Attributs: SupportedOSPlatformAttribute

Exceptions

ArgumentNullException

keyName ou provider est null.

PlatformNotSupportedException

Le chiffrement de nouvelle génération (CNG) 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. En outre, une valeur par défaut CngKeyOpenOptions est None 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

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

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

public:
 static System::Security::Cryptography::CngKey ^ Open(System::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);

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

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

KSP qui contient la clé.

openOptions: CngKeyOpenOptions

Combinaison de bits des valeurs d’énumération qui spécifient les options d’ouverture de la clé, telles que l’emplacement d’ouverture de la clé (machine ou stockage utilisateur) et la suppression de l’invite d’interface utilisateur.

Retours

CngKey

Clé existante.

Attributs: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

keyName ou provider est null.

PlatformNotSupportedException

Le chiffrement de nouvelle génération (CNG) 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é.

S’applique à

Commentaires

Cette page a-t-elle été utile ?