Método PrivateKey.Open

[El método Open está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En su lugar, use la propiedad X509Certificate2.PrivateKey en el espacio de nombres System.Security.Cryptography.X509Certificates .

El método Open tiene acceso a un contenedor de claves existente. Este método asocia el contenedor de claves al certificado que corresponde a la clave privada agregando la propiedad CERT_KEY_PROV_INFO_PROP_ID mediante la información especificada.

Sintaxis

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

Parámetros

ContainerName [in]

Cadena que contiene el nombre del contenedor de claves.

ProviderName [in, optional]

Cadena que contiene el nombre del proveedor. El valor predeterminado es CAPICOM_PROV_MS_ENHANCED_PROV. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_PROV_MS_DEF_PROV	Proveedor criptográfico base de Microsoft.
CAPICOM_PROV_MS_ENHANCED_PROV	Proveedor criptográfico mejorado de Microsoft.
CAPICOM_PROV_MS_STRONG_PROV	Proveedor criptográfico seguro de Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Proveedor criptográfico de firma RSA de Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Proveedor criptográfico Schannel de Microsoft RSA.
CAPICOM_PROV_MS_DEF_DSS_PROV	Proveedor criptográfico de DSS base de Microsoft.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	DSS base de Microsoft y Diffie-Hellman proveedor criptográfico.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	DSS mejorado de Microsoft y Diffie-Hellman proveedor criptográfico.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Proveedor criptográfico Schannel de Microsoft DH.
CAPICOM_PROV_MS_SCARD_PROV	Proveedor criptográfico de tarjeta inteligente base de Microsoft.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Proveedor criptográfico RSA y AES mejorado por Microsoft.

 

ProviderType [in, opcional]

Valor de la enumeración CAPICOM_PROV_TYPE que especifica un tipo de proveedor. El valor predeterminado es CAPICOM_PROV_RSA_FULL. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_PROV_RSA_FULL	Proveedor completo de servicios criptográficosRSA (CSP). Este tipo de proveedor admite tanto firmas digitales como cifrado de datos.
CAPICOM_PROV_RSA_SIG	Subconjunto del CSP rsa que solo admite esas funciones y algoritmos que son necesarios para hashes y firmas digitales.
CAPICOM_PROV_DSS	CSP de Digital Signature Standard (DSS). Este tipo de proveedor solo admite hashes y firmas digitales. DSS usa el algoritmo de firma digital (DSA).
CAPICOM_PROV_FORTEZZA	CSP que contiene los protocolos criptográficos y algoritmos que pertenecen al Instituto Nacional de Estándares y Tecnología (NIST).
CAPICOM_PROV_MS_EXCHANGE	CSP que admite la aplicación de correo de Microsoft Exchange y otras aplicaciones compatibles con Microsoft Mail.
CAPICOM_PROV_SSL	CSP que admite el protocolo Capa de sockets seguros (SSL).
CAPICOM_PROV_RSA_SCHANNEL	CSP que admite protocolos RSA y Schannel .
CAPICOM_PROV_DSS_DH	CSP que admite protocolos DSS y Diffie-Hellman .
CAPICOM_PROV_EC_ECDSA_SIG	CSP que admite las funciones y algoritmos de algoritmo de firma digital de curva elíptica (ECDSA) necesarios para firmas digitales.
CAPICOM_PROV_EC_ECNRA_SIG	Csp que admite las funciones y algoritmos de curva elíptica Nyberg-Rueppel analógico (ECNRA) necesarios para las firmas digitales.
CAPICOM_PROV_EC_ECDSA_FULL	CSP que admite el ECDSA completo.
CAPICOM_PROV_EC_ECNRA_FULL	CSP que admite el ECNRA completo.
CAPICOM_PROV_DH_SCHANNEL	CSP que admite protocolos Diffie-Hellman y Schannel .
CAPICOM_PROV_SPYRUS_LYNKS	CSP que admite el dispositivo de tarjeta SPYRUS LYNKS.
CAPICOM_PROV_RNG	CSP que controla la generación de números aleatorios.
CAPICOM_PROV_INTEL_SEC	CSP que proporciona seguridad intel.
CAPICOM_PROV_REPLACE_OWF	CSP que admite la sustitución de la manera en que se generan formatos unidireccionales a partir de contraseñas.
CAPICOM_PROV_RSA_AES	CSP que admite firmas digitales y cifrado de datos mediante el algoritmo Advanced Encryption Standard (AES).

 

KeySpec [in, optional]

Valor de la enumeración CAPICOM_KEY_SPEC que especifica el tipo de clave privada. El valor predeterminado es CAPICOM_KEY_SPEC_SIGNATURE. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_KEY_SPEC_KEYEXCHANGE	La clave se puede usar para el cifrado y la firma.
CAPICOM_KEY_SPEC_SIGNATURE	La clave solo se puede usar para firmar.

 

StoreLocation [in, optional]

Valor de la enumeración CAPICOM_STORE_LOCATION que especifica la ubicación del almacén donde reside la clave. El valor predeterminado es CAPICOM_CURRENT_USER_STORE. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_MEMORY_STORE	El almacén es un almacén de memoria. No se conservan los cambios en el contenido del almacén.
CAPICOM_LOCAL_MACHINE_STORE	El almacén es un almacén de equipos local. Los almacenes de equipos locales solo pueden ser almacenes de lectura y escritura si el usuario tiene permisos de lectura y escritura. Si el usuario tiene permisos de lectura y escritura y si el almacén se abre de lectura y escritura, se conservan los cambios en el contenido del almacén.
CAPICOM_CURRENT_USER_STORE	El almacén es un almacén de usuarios actual. Un almacén de usuario actual puede ser un almacén de lectura y escritura. Si es así, se conservan los cambios en el contenido del almacén.
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	El almacén es un almacén de Active Directory. Los almacenes de Active Directory solo se pueden abrir en modo de solo lectura. Los certificados no se pueden agregar ni quitar de los almacenes de Active Directory.
CAPICOM_SMART_CARD_USER_STORE	La tienda es el grupo de tarjetas inteligentes presentes. Introducido en CAPICOM 2.0.

 

bCheckExistence [in, optional]

Valor booleano que indica si CAPICOM intentará acceder a la clave. Si es True, CAPICOM intenta acceder a la clave. Si la clave está protegida por el usuario o en una tarjeta inteligente u otro dispositivo, se puede generar un cuadro de diálogo. El valor predeterminado es False.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Este método devuelve CAPICOM_E_NOT_ALLOWED cuando se crea un script desde una aplicación basada en web.

Requisitos

Requisito	Value
Redistribuible	CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP
Archivo DLL	Capicom.dll

Consulte también

PrivateKey

Certificate.HasPrivateKey