File: gpgme.info,  Node: Selecting Signers,  Next: Signature.php">Creating a Signature,  Up: Sign

7.6.4.1 Selecting Signers
.........................

The key or the keys used to create a signature are stored in the
context.  The following functions can be used to manipulate this list.
If no signer has been set into the context a default key is used for
signing.

 -- Function: void gpgme_signers_clear (gpgme_ctx_t CTX)
     The function ‘gpgme_signers_clear’ releases a reference for each
     key on the signers list and removes the list of signers from the
     context CTX.

     Every context starts with an empty list.

 -- Function: gpgme_error_t gpgme_signers_add (gpgme_ctx_t CTX,
          const gpgme_key_t KEY)
     The function ‘gpgme_signers_add’ adds the key KEY to the list of
     signers in the context CTX.

     Calling this function acquires an additional reference for the key.

 -- Function: unsigned int gpgme_signers_count (const gpgme_ctx_t CTX)
     SINCE: 1.4.3

     The function ‘gpgme_signers_count’ returns the number of signer
     keys in the context CTX.

 -- Function: gpgme_key_t gpgme_signers_enum (const gpgme_ctx_t CTX,
          int SEQ)
     The function ‘gpgme_signers_enum’ returns the SEQth key in the list
     of signers in the context CTX.  An additional reference is acquired
     for the user.

     If SEQ is out of range, ‘NULL’ is returned.