GNU Info

(gpgme.info)Deleting Keys

---

Prev: Importing Keys Up: Key Management

---

Enter node , (file) or (file)node

Deleting Keys
-------------

 - Function: GpgmeError gpgme_op_delete (GpgmeCtx CTX,
          const GpgmeKey KEY, int ALLOW_SECRET)
     The function `gpgme_op_delete' deletes the key KEY from the key
     ring of the crypto engine used by CTX.  If ALLOW_SECRET is `0',
     only public keys are deleted, otherwise secret keys are deleted as
     well.

     The function returns `GPGME_No_Error' if the key was deleted
     successfully, `GPGME_Invalid_Value' if CTX or KEY is not a valid
     pointer, `GPGME_Invalid_Key' if KEY could not be found in the
     keyring, and `GPGME_Conflict' if the secret key for KEY is
     available, but ALLOW_SECRET is zero.

 - Function: GpgmeError gpgme_op_delete_start (GpgmeCtx CTX,
          const GpgmeKey KEY, int ALLOW_SECRET)
     The function `gpgme_op_delete_start' initiates a `gpgme_op_delete'
     operation.  It can be completed by calling `gpgme_wait' on the
     context.  Note: Waiting For Completion.

     The function returns `GPGME_No_Error' if the operation was started
     successfully, and `GPGME_Invalid_Value' if CTX or KEY is not a
     valid pointer.