Share via


PFXVerifyPassword

A version of this page is also available for

Windows Embedded CE 6.0 R3

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_BLOB structure 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 SecureZeroMemory function.

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

Reference

Certificates Functions