CertCompareCertificateName function

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 WINAPI CertCompareCertificateName(
  _In_ DWORD           dwCertEncodingType,
  _In_ PCERT_NAME_BLOB pCertName1,
  _In_ PCERT_NAME_BLOB pCertName2
);

Parameters

dwCertEncodingType [in]

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

pCertName1 [in]

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

pCertName2 [in]

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).

Examples

For an example that uses this function, see Example C Program: Deleting Certificates from a Certificate Store.

Requirements

See also

CertCompareCertificate

CERT_NAME_BLOB

Data Management Functions