One-line description of what the function does (more than just what it returns).
Syntax
#include <headers.h>
ReturnType Function_Name(
ParamType ParamName,
ParamType ParamName, );
Parameters
ParamName | Sample: in pointer to a CERTCertDBHandle representing the certificate database to look in |
ParamName | Sample: in pointer to an SECItem whose type must be siDERCertBuffer and whose data contains a DER-encoded certificate |
Description
Long description of this function, what it does, and why you would use it. Describe all side-effects on "out" parameters. Avoid describing the return until the next section, for example:
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
Full description of the return value, for example:
A pointer to a 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 to decrement the reference count on the certificate instance.
See Also
Copy of the MXR link, with the following text
Occurrences of Function_Name in the current NSS source code (generated by MXR).