GNU Info

(gpgme.info)Listing Trust Items

---

Next: Information About Trust Items Up: Trust Item Management

---

Enter node , (file) or (file)node

Listing Trust Items
-------------------

 - Function: GpgmeError gpgme_op_trustlist_start (GpgmeCtx CTX,
          const char *PATTERN, int MAX_LEVEL)
     The function `gpgme_op_trustlist_start' initiates a trust item
     listing operation inside the context CTX.  It sets everything up
     so that subsequent invocations of `gpgme_op_trustlist_next' return
     the trust items in the list.

     The string PATTERN contains an engine specific expression that is
     used to limit the list to all trust items matching the pattern.  It
     can not be the empty string.

     The argument MAX_LEVEL is currently ignored.

     The context will be busy until either all trust items are received
     (and `gpgme_op_trustlist_next' returns `GPGME_EOF'), or
     `gpgme_op_trustlist_end' is called to finish the operation.

     The function returns `GPGME_Invalid_Value' if CTX is not a valid
     pointer, and passes through any errors that are reported by the
     crypto engine support routines.

 - Function: GpgmeError gpgme_op_trustlist_next (GpgmeCtx CTX,
          GpgmeTrustItem *R_ITEM)
     The function `gpgme_op_trustlist_next' returns the next trust item
     in the list created by a previous `gpgme_op_trustlist_start'
     operation in the context CTX.  The trust item can be destroyed
     with `gpgme_trust_item_release'.  Note: Manipulating Trust Items.

     This is the only way to get at `GpgmeTrustItem' objects in GPGME.

     If the last trust item in the list has already been returned,
     `gpgme_op_trustlist_next' returns `GPGME_EOF'.

     The function returns `GPGME_Invalid_Value' if CTX or R_ITEM is not
     a valid pointer, `GPGME_No_Request' if there is no pending
     operation, `GPGME_Out_Of_Core' if there is not enough memory for
     the operation.

 - Function: GpgmeError gpgme_op_trustlist_end (GpgmeCtx CTX)
     The function `gpgme_op_trustlist_next' ends a pending key list
     operation in the context CTX.

     The function returns `GPGME_Invalid_Value' if CTX is not a valid
     pointer, `GPGME_No_Request' if there is no pending operation,
     `GPGME_Out_Of_Core' if at some time during the operation there was
     not enough memory available.