Método ICEnroll4::createPFX (xenroll.h)

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método createPFX guarda la cadena de certificados aceptada y la clave privada en una cadena de formato de Intercambio de información personal (PFX). El formato PFX también se conoce como PKCS #12.

Este método se definió por primera vez en la interfaz ICEnroll4 .

Sintaxis

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Parámetros

[in] strPassword

Una contraseña para el mensaje de formato PFX. Este valor puede estar vacío o NULL para indicar que no se usa ninguna contraseña. Cuando haya terminado de usar la contraseña, desactive la memoria llamando a la función SecureZeroMemory . Para obtener más información sobre cómo proteger la contraseña, consulte Control de contraseñas.

[out] pstrPFX

Puntero a un BSTR que recibe la información del certificado de formato PFX codificado en base64. Cuando haya terminado de usar BSTR, ábrelo llamando a la función SysFreeString .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es una cadena que contiene la información del certificado de formato PFX.

Observaciones

Este método se deshabilita cuando el control de inscripción de certificados se ejecuta como un control con scripts.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xenroll.h
Library	Uuid.lib
Archivo DLL	Xenroll.dll