Método IX509Enrollment::CreatePFX (certenroll.h)

  • Artículo

El método CreatePFX crea un mensaje de intercambio de información personal (PFX). El mensaje se encuentra en una matriz de bytes que se codifica mediante reglas de codificación distinguida (DER) tal y como se define en el estándar Notación de sintaxis abstracta Uno (ASN.1). La matriz de bytes con codificación DER se representa mediante una cadena que es una secuencia binaria pura o está codificada con Unicode.

Sintaxis

HRESULT CreatePFX(
  [in]  BSTR             strPassword,
  [in]  PFXExportOptions ExportOptions,
  [in]  EncodingType     Encoding,
  [out] BSTR             *pValue
);

Parámetros

[in] strPassword

Variable BSTR que contiene una contraseña para el mensaje PFX. Puede ser NULL para indicar que no se usa ninguna contraseña. Cuando haya terminado de usar la contraseña, desactive la memoria mediante una llamada a la función SecureZeroMemory . Para obtener más información sobre cómo proteger la contraseña, consulte Control de contraseñas.

[in] ExportOptions

Valor de enumeración PFXExportOptions que especifica la cantidad de la cadena de certificados que se exporta. Solo puede exportar el certificado, la cadena de certificados sin la raíz o toda la cadena.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada al mensaje codificado en DER. El valor predeterminado es XCN_CRYPT_STRING_BASE64.

[out] pValue

Puntero a una variable BSTR que contiene el mensaje PFX codificado en DER.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
CERTSRV_E_PROPERTY_EMPTY
 No se encuentra el certificado.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 No se puede encontrar ninguna cadena de certificados.
OLE_E_BLANK
 El objeto de inscripción no se ha inicializado.

Comentarios

El formato PFX también se conoce como PKCS #12. El método CreatePFX :

  • Abre el almacén de certificados en memoria para el proveedor predeterminado.
  • Agrega el certificado instalado al almacén o compila la cadena de certificados agrega un vínculo a él.
  • Exporta el certificado y la clave privada a un mensaje PFX en función de las opciones de exportación especificadas.
  • Codifica el mensaje exportado mediante DER.

Antes de llamar a este método, debe inicializar el objeto IX509Enrollment llamando a uno de los métodos siguientes.

Además, debe devolver correctamente desde el método Enroll .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IX509Enrollment