File: gpgme.info,  Node: Included Certificates,  Next: Key Listing Mode,  Prev: Pinentry Mode,  Up: Context Attributes

7.4.8 Included Certificates
---------------------------

 -- Function: void gpgme_set_include_certs (gpgme_ctx_t CTX,
          int NR_OF_CERTS)
     The function ‘gpgme_set_include_certs’ specifies how many
     certificates should be included in an S/MIME signed message.  By
     default, only the sender’s certificate is included.  The possible
     values of NR_OF_CERTS are:

     ‘GPGME_INCLUDE_CERTS_DEFAULT’
          SINCE: 1.0.3

          Fall back to the default of the crypto backend.  This is the
          default for GPGME.
     ‘-2’
          Include all certificates except the root certificate.
     ‘-1’
          Include all certificates.
     ‘0’
          Include no certificates.
     ‘1’
          Include the sender’s certificate only.
     ‘n’
          Include the first n certificates of the certificates path,
          starting from the sender’s certificate.  The number ‘n’ must
          be positive.

     Values of NR_OF_CERTS smaller than -2 are undefined.

     This option is only relevant to the CMS crypto engine, and ignored
     by all other engines.

 -- Function: int gpgme_get_include_certs (gpgme_ctx_t CTX)
     The function ‘gpgme_get_include_certs’ returns the number of
     certificates to include into an S/MIME signed message.