CertCompareCertificateName

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function compares two certificate CERT_NAME_BLOB structures to determine whether they are identical. CERT_NAME_BLOB structures are used for the subject and the issuer of certificates.

Syntax

BOOL WINAPI CertCompareCertificateName(
  DWORD dwCertEncodingType,
  PCERT_NAME_BLOB pCertName1,
  PCERT_NAME_BLOB pCertName2
);

Parameters

  • dwCertEncodingType
    [in] Encoding type used. Currently, only X509_ASN_ENCODING is used; however, additional encoding types may be added in the future.
  • pCertName1
    [in] Pointer to a CERT_NAME_BLOB structure for the first name in the comparison.
  • pCertName2
    [in] Pointer to a CERT_NAME_BLOB structure for the second name in the comparison.

Return Value

If the names are identical and the function succeeds, the return value is nonzero, or TRUE.

If the function fails, the return value is zero, or FALSE.

Remarks

The desktop operating system supports the flag PKCS_7_ASN_ENCODING, but Windows Embedded CE does not and ignores the flag when it is specified.

Requirements

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

See Also

Reference

CertCompareCertificate
BLOB (Cryptography)