Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function attempts to decode the outer layer of a BLOB as a Personal Information Exchange (PFX) packet and to decrypt it with the given password. No data from the BLOB is imported.

PFX format is also known as Public-Key Cryptography Standards #12 (PKCS #12) format.

Syntax 

BOOL WINAPI PFXVerifyPassword(
  CRYPT_DATA_BLOB* 
pPFX,
  LPCWSTR 
szPassword,
  DWORD 
dwFlags
);

Parameters

pPFX

[in] Pointer to a CRYPT_DATA_BLOBstructure that the function will attempt to decode as a PFX packet.

szPassword

[in] String password to be checked. For this function to succeed, this password must be exactly the same as the password used to encrypt the packet.

dwFlags

[in] Reserved for future use. Must be set to zero.

Return Value

The function return TRUE if the password appears correct; otherwise, it returns FALSE.

Remarks

When you have finished using szPassword, clear the password from memory by calling the SecureZeroMemoryfunction.

Requirements

Header wincrypt.h
Library crypt32.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also