Compartir a través de


Método IEnroll4::createPFXWStr (xenroll.h)

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

El método createPFXWStr 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 IEnroll4 .

Sintaxis

HRESULT createPFXWStr(
  [in]  LPCWSTR          pwszPassword,
  [out] PCRYPT_DATA_BLOB pblobPFX
);

Parámetros

[in] pwszPassword

Puntero a una cadena Unicode terminada en null que representa la contraseña del 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, quite la información confidencial de la memoria llamando a SecureZeroMemory. Para obtener más información sobre cómo proteger la contraseña, consulte Control de contraseñas.

[out] pblobPFX

Puntero a la estructura de CRYPT_DATA_BLOB que recibe la información del certificado de formato PFX codificado en base64.

Cuando haya terminado de usar esta memoria, libere el miembro pbData de esta estructura a la función CoTaskMemFree .

Valor devuelto

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.

Requisitos

Requisito Value
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

Consulte también

IEnroll4