Source code
Revision control
Copy as Markdown
Other Tools
.. _mozilla_projects_nss_cert_findcertbydercert:
CERT_FindCertByDERCert
======================
.. container::
Find a certificate in the database that matches a DER-encoded certificate.
`Syntax <#syntax>`__
~~~~~~~~~~~~~~~~~~~~
.. container::
.. code::
#include <cert.h>
CERTCertificate *CERT_FindCertByDERCert(
CERTCertDBHandle *handle,
SECItem *derCert );
`Parameters <#parameters>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
+-------------+-----------------------------------------------------------------------------------+
| ``handle`` | *in* pointer to a `CERTCertDBHandle </en-US/NSS/CERTCertDBHandle>`__ representing |
| | the certificate database to look in |
+-------------+-----------------------------------------------------------------------------------+
| ``derCert`` | *in* pointer to an `SECItem </en-US/NSS/SECItem>`__ whose ``type`` must be |
| | ``siDERCertBuffer`` and whose ``data`` contains a DER-encoded certificate |
+-------------+-----------------------------------------------------------------------------------+
`Description <#description>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
This function looks in the ?NSSCryptoContext? and the ?NSSTrustDomain? to find the certificate
that matches the DER-encoded certificate. A match is found when the issuer and serial number of
the DER-encoded certificate are found on a certificate in the certificate database.
`Returns <#returns>`__
~~~~~~~~~~~~~~~~~~~~~~
.. container::
A pointer to a `CERTCertificate </en-US/NSS/CERTCertificate>`__ representing the certificate in
the database that matched the ``derCert``, or ``NULL`` if none was found. The certificate is a
shallow copy, use `CERT_DestroyCertificate </en-US/NSS/CERT_DestroyCertificate>`__ to decrement
the reference count on the certificate instance.
.. _see_also:
`See Also <#see_also>`__
~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
Occurrences of