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 compares two certificate CERT_NAME_BLOBstructures to determine whether they are identical. CERT_NAME_BLOBstructures 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_BLOBstructure for the first name in the comparison.

pCertName2

[in] Pointer to a CERT_NAME_BLOBstructure 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