CertCompareCertificateName function (wincrypt.h)

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

Syntax

BOOL CertCompareCertificateName(
  [in] DWORD           dwCertEncodingType,
  [in] PCERT_NAME_BLOB pCertName1,
  [in] PCERT_NAME_BLOB pCertName2
);

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] pCertName1

A pointer to a CERT_NAME_BLOB for the first name in the comparison. For more information, see CRYPT_INTEGER_BLOB.

[in] pCertName2

A pointer to a CERT_NAME_BLOB for the second name in the comparison.

Return value

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

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

Requirements

See also

CERT_NAME_BLOB

CertCompareCertificate

Data Management Functions