Método Store.Load

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

El método Load importa certificados de un archivo en el almacén.

Sintaxis

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Parámetros

FileName [in]

Cadena que contiene la ruta de acceso a un archivo .cer, .sst, .spc, .p7s o .pfx, o cualquier archivo con signo Authenticode.

Contraseña [in, opcional]

Cadena que contiene la contraseña de texto no cifrado en el archivo. Se pueden usar hasta 32 caracteres Unicode, incluido un carácter nulo de terminación, para la contraseña. Para obtener información sobre cómo proteger la contraseña, consulte Control de contraseñas.

KeyStorageFlag [in, optional]

Valor de la enumeración CAPICOM_KEY_STORAGE_FLAG que define las marcas de almacenamiento de claves. El valor predeterminado es CAPICOM_KEY_STORAGE_DEFAULT. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
CAPICOM_KEY_STORAGE_DEFAULT
Almacenamiento de claves predeterminado.
CAPICOM_KEY_STORAGE_EXPORTABLE
La clave es exportable.
CAPICOM_KEY_STORAGE_USER_PROTECTED
La clave está protegida por el usuario.

 

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Si se llama al método Load en un almacén de memoria, los contenedores de claves creados se eliminarán cuando se elimine el almacén de memoria. Por ejemplo, si un archivo .pfx se carga en un almacén de memoria y posteriormente se agrega a un almacén del sistema (como Mi almacén) desde el almacén de memoria, el certificado en Mi almacén no contendrá una clave. En este caso, el archivo .pfx debe cargarse directamente en mi almacén.

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

Si la contraseña no puede descifrar el archivo de clave privada, se debe consultar el proveedor de servicios criptográficos (CSP) predeterminado. Si el CSP predeterminado es el proveedor criptográfico base de Microsoft y se produce un error en la operación de descifrado, la operación de descifrado se debe volver a intentar con el proveedor criptográfico seguro de Microsoft o con el proveedor criptográfico mejorado de Microsoft, lo que esté disponible.

Si el certificado que se carga en el almacén es el mismo que el que ya existe, el método Load eliminará el certificado existente del almacén y, a continuación, agregará el nuevo certificado. El nuevo certificado heredará las propiedades del certificado existente. El contenedor de claves privadas existente se reemplaza por el nuevo contenedor de claves privadas.

Requisitos

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

Consulte también

Tienda