PrivateKey.Open, méthode

Article
06/13/2023

[La méthode Open peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Utilisez plutôt la propriété X509Certificate2.PrivateKey dans l’espace de noms System.Security.Cryptography.X509Certificates .]

La méthode Open accède à un conteneur de clés existant. Cette méthode associe le conteneur de clé au certificat qui correspond à la clé privée en ajoutant la propriété CERT_KEY_PROV_INFO_PROP_ID à l’aide des informations spécifiées.

Syntaxe

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

Paramètres

ContainerName [in]

Chaîne qui contient le nom du conteneur de clés.

ProviderName [in, optional]

Chaîne qui contient le nom du fournisseur. La valeur par défaut est CAPICOM_PROV_MS_ENHANCED_PROV. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_PROV_MS_DEF_PROV	Fournisseur de chiffrement de base Microsoft.
CAPICOM_PROV_MS_ENHANCED_PROV	Fournisseur de chiffrement amélioré Microsoft.
CAPICOM_PROV_MS_STRONG_PROV	Fournisseur de chiffrement fort Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Fournisseur de chiffrement de signature RSA Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Fournisseur de chiffrement Microsoft RSA Schannel.
CAPICOM_PROV_MS_DEF_DSS_PROV	Fournisseur de chiffrement DSS de base Microsoft.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	Microsoft base DSS et Diffie-Hellman fournisseur de chiffrement.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	Microsoft DSS amélioré et fournisseur de chiffrement Diffie-Hellman.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Fournisseur de chiffrement Microsoft DH Schannel.
CAPICOM_PROV_MS_SCARD_PROV	Fournisseur de chiffrement smart carte de base Microsoft.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Fournisseur de chiffrement RSA et AES améliorés de Microsoft.

ProviderType [in, facultatif]

Valeur de l’énumération CAPICOM_PROV_TYPE qui spécifie un type de fournisseur. La valeur par défaut est CAPICOM_PROV_RSA_FULL. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_PROV_RSA_FULL	Fournisseur de services de chiffrementRSA complet. Ce type de fournisseur prend en charge les signatures numériques et le chiffrement des données.
CAPICOM_PROV_RSA_SIG	Sous-ensemble du csp RSA qui prend en charge uniquement les fonctions et les algorithmes requis pour les hachages et lessignatures numériques.
CAPICOM_PROV_DSS	Fournisseur de services de configuration DSS (Digital Signature Standard ). Ce type de fournisseur prend uniquement en charge les hachages et les signatures numériques. DSS utilise l’algorithme de signature numérique (DSA).
CAPICOM_PROV_FORTEZZA	Csp qui contient les protocoles de chiffrement et les algorithmes appartenant au National Institute of Standards and Technology (NIST).
CAPICOM_PROV_MS_EXCHANGE	Csp qui prend en charge l’application de messagerie Microsoft Exchange et d’autres applications compatibles avec Microsoft Mail.
CAPICOM_PROV_SSL	Csp qui prend en charge le protocole SSL ( Secure Sockets Layer ).
CAPICOM_PROV_RSA_SCHANNEL	Csp qui prend en charge les protocoles RSA et Schannel .
CAPICOM_PROV_DSS_DH	Csp qui prend en charge les protocoles DSS et Diffie-Hellman .
CAPICOM_PROV_EC_ECDSA_SIG	Fournisseur de services de configuration qui prend en charge les fonctions et algorithmes ECDSA (Elliptic Curve Digital Signature Algorithm) requis pour les signatures numériques.
CAPICOM_PROV_EC_ECNRA_SIG	Fournisseur de services de configuration qui prend en charge les fonctions et algorithmes ecnRA (Elliptic Curve Nyberg-Rueppel Analog) et les algorithmes requis pour les signatures numériques.
CAPICOM_PROV_EC_ECDSA_FULL	Fournisseur de services de configuration qui prend en charge l’ECDSA complet.
CAPICOM_PROV_EC_ECNRA_FULL	Csp qui prend en charge l’ECNRA complet.
CAPICOM_PROV_DH_SCHANNEL	Csp qui prend en charge les protocoles Diffie-Hellman et Schannel .
CAPICOM_PROV_SPYRUS_LYNKS	Csp qui prend en charge l’appareil SPYRUS LYNKS Card.
CAPICOM_PROV_RNG	Csp qui gère la génération de nombres aléatoires.
CAPICOM_PROV_INTEL_SEC	Fournisseur de services de configuration qui fournit la sécurité Intel.
CAPICOM_PROV_REPLACE_OWF	Csp qui prend en charge le remplacement de la façon dont les formats unidirectionnel sont générés à partir des mots de passe.
CAPICOM_PROV_RSA_AES	Csp qui prend en charge à la fois les signatures numériques et le chiffrement des données à l’aide de l’algorithme AES (Advanced Encryption Standard).

KeySpec [in, facultatif]

Valeur de l’énumération CAPICOM_KEY_SPEC qui spécifie le type de clé privée. La valeur par défaut est CAPICOM_KEY_SPEC_SIGNATURE. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_KEY_SPEC_KEYEXCHANGE	La clé peut être utilisée pour le chiffrement et la signature.
CAPICOM_KEY_SPEC_SIGNATURE	La clé peut être utilisée uniquement pour la signature.

StoreLocation [in, facultatif]

Valeur de l’énumération CAPICOM_STORE_LOCATION qui spécifie l’emplacement du magasin où réside la clé. La valeur par défaut est CAPICOM_CURRENT_USER_STORE. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_MEMORY_STORE	Le magasin est un magasin de mémoire. Les modifications apportées au contenu du magasin ne sont pas conservées.
CAPICOM_LOCAL_MACHINE_STORE	Le magasin est un magasin d’ordinateurs local. Les magasins d’ordinateurs locaux ne peuvent être des magasins en lecture/écriture que si l’utilisateur dispose d’autorisations en lecture/écriture. Si l’utilisateur dispose d’autorisations de lecture/écriture et si le magasin est ouvert en lecture/écriture, les modifications apportées au contenu du magasin sont conservées.
CAPICOM_CURRENT_USER_STORE	Le magasin est un magasin d’utilisateurs actuel. Un magasin d’utilisateurs actuel peut être un magasin de lecture/écriture. Si c’est le cas, les modifications apportées au contenu du magasin sont conservées.
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	Le magasin est un magasin Active Directory. Les magasins Active Directory ne peuvent être ouverts qu’en mode lecture seule. Les certificats ne peuvent pas être ajoutés ou supprimés des magasins Active Directory.
CAPICOM_SMART_CARD_USER_STORE	Le magasin est le groupe de cartes à puce présentes. Introduit dans CAPICOM 2.0.

bCheckExistence [in, facultatif]

Valeur booléenne qui indique si CAPICOM tente d’accéder à la clé. Si la valeur est True, CAPICOM tente d’accéder à la clé. Si la clé est protégée par l’utilisateur ou sur un carte intelligent ou un autre appareil, une boîte de dialogue peut être générée. La valeur par défaut est False.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode retourne CAPICOM_E_NOT_ALLOWED lorsqu’elle est scriptée à partir d’une application web.

Spécifications

Condition requise	Valeur
Composant redistribuable	CAPICOM 2.0 ou version ultérieure sur Windows Server 2003 et Windows XP
DLL	Capicom.dll

Voir aussi

PrivateKey
Certificate.HasPrivateKey