Método ICertificate2::Save

[CAPICOM es un componente solo de 32 bits que está disponible para su uso en los siguientes sistemas operativos: Windows Server 2008, Windows Vista y Windows XP. En su lugar, use la clase X509Certificate2 en el espacio de nombres System.Security.Cryptography.X509Certificates .

El método Save guarda el certificado en un archivo. Este método se introdujo en CAPICOM 2.0.

Sintaxis

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Parámetros

FileName [in]

Cadena que contiene el nombre del archivo de salida donde se guardará el certificado.

Contraseña [in, opcional]

Cadena que contiene la contraseña de texto no cifrado para un archivo de clave privada . La contraseña puede contener hasta 32 caracteres Unicode, incluido un carácter nulo de terminación. Para obtener información sobre cómo proteger la contraseña, consulte Control de contraseñas.

SaveAs [in, opcional]

Valor de la enumeración CAPICOM_CERTIFICATE_SAVE_AS_TYPE que especifica el formato del archivo de salida. El valor predeterminado es CAPICOM_CERTIFICATE_SAVE_AS_CER. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
CAPICOM_CERTIFICATE_SAVE_AS_CER	El archivo de salida tendrá el formato .cer sin claves privadas guardadas.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	El archivo de salida tendrá el formato .pfx (PKCS #12) y las claves privadas asociadas que se puedan exportar también se guardarán.

 

IncludeOption [in, opcional]

Valor de la enumeración CAPICOM_CERTIFICATE_INCLUDE_OPTION que especifica cuántos certificados de la cadena se guardan en el archivo de salida. El valor predeterminado es CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Guarda todos los certificados de la cadena con la excepción de la entidad raíz.
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Guarda la cadena de certificados completa.
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Guarda solo el certificado de entidad final.

 

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

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

Requisitos

Requisito	Value
Fin de compatibilidad de cliente	Windows Vista
Fin de compatibilidad de servidor	Windows Server 2008
Redistribuible	CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP
Archivo DLL	Capicom.dll