CertCompareCertificate function (wincrypt.h)

The CertCompareCertificate function determines whether two certificates are identical by comparing the issuer name and serial number of the certificates.

Caution  The CertCompareCertificate function must not be used for security assertions because it does not compare BLOBs.
 

Syntax

BOOL CertCompareCertificate(
  [in] DWORD      dwCertEncodingType,
  [in] PCERT_INFO pCertId1,
  [in] PCERT_INFO pCertId2
);

Parameters

[in] dwCertEncodingType

Specifies the encoding type used. It is always acceptable to specify both the certificate and message encoding types by combining them with a bitwise-OR operation as shown in the following example:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Currently defined encoding types are:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pCertId1

A pointer to the CERT_INFO for the first certificate in the comparison.

[in] pCertId2

A pointer to the CERT_INFO for the second certificate in the comparison.

Return value

If the certificates are identical and the function succeeds, the function returns nonzero (TRUE).

If the function fails, it returns zero (FALSE).

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

See also

CERT_INFO

CertCompareCertificateName

Data Management Functions