Compartir a través de

Función PFXVerifyPassword (wincrypt.h)

  • Artículo

La función PFXVerifyPassword intenta descodificar la capa externa de un BLOB como un paquete de Intercambio de información personal (PFX) y descifrarla con la contraseña especificada. No se importa ningún dato del BLOB.

El formato PFX también se conoce como el formato Public-Key Cryptography Standards #12 (PKCS #12).

Sintaxis

BOOL PFXVerifyPassword(
  [in] CRYPT_DATA_BLOB *pPFX,
  [in] LPCWSTR         szPassword,
  [in] DWORD           dwFlags
);

Parámetros

[in] pPFX

Puntero a una estructura CRYPT_DATA_BLOB que la función intentará descodificar como un paquete PFX.

[in] szPassword

Contraseña de cadena que se va a comprobar. Para que esta función se realice correctamente, esta contraseña debe ser exactamente la misma que la contraseña usada para cifrar el paquete.

Si establece este valor en una cadena vacía o NULL, esta función normalmente intenta descifrar la contraseña insertada en el BLOB PFX mediante la cadena vacía o NULL.

Sin embargo, a partir de Windows 8 y Windows Server 2012, si se especificó una contraseña NULA o vacía cuando se creó el BLOB PFX y la aplicación también especificó que la contraseña debe protegerse en una entidad de seguridad de Active Directory (AD), la API de criptografía (CAPI) genera aleatoriamente una contraseña, la cifra en la entidad de seguridad de AD e la inserta en el BLOB PFX. A continuación, la función PFXVerifyPassword intentará usar la entidad de seguridad de AD especificada (usuario actual, equipo o miembro del grupo de AD) para descifrar la contraseña. Para obtener más información sobre cómo proteger PFX en una entidad de seguridad de AD, consulte el parámetro pvPara y la marca PKCS12_PROTECT_TO_DOMAIN_SIDS de la función PFXExportCertStoreEx .

Cuando haya terminado de usar la contraseña, desactive la contraseña de la memoria llamando a la función SecureZeroMemory . Para obtener más información sobre cómo proteger las contraseñas, consulte Control de contraseñas.

[in] dwFlags

Reservado para uso futuro.

Valor devuelto

La función devuelve TRUE si la contraseña aparece correcta; de lo contrario, devuelve FALSE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Crypt32.lib
Archivo DLL Crypt32.dll