— 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

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.