TLSRPT_CANCEL_DELIVERY_REQUEST(3)               tlsrpt_cancel_delivery_request

NAME
       tlsrpt_cancel_delivery_request - marks the delivery request as
       cancelled

SYNOPSIS
       #include <tlsrpt.h>

       int tlsrpt_cancel_delivery_request(struct tlsrpt_dr_t** pdr)

DESCRIPTION
       The tlsrpt_cancel_delivery_request function marks the delivery request
       as cancelled.  This is done by an internal library "dummy error"
       TLSRPT_ERR_TLSRPT_CANCELLED which, like all errors, will prevent the
       delivery request from being sent out.  The function then calls
       tlsrpt_finish_delivery_request, which will do all the clean-up of used
       resources.

RETURN VALUE
       The tlsrpt_cancel_delivery_request function returns 0 on success and a
       combined error code on failure.  The combined error code can be
       analyzed with the tlsrpt_strerror function.

SEE ALSO
       man:tlsrpt_init_delivery_request[3],
       man:tlsrpt_finish_delivery_request[3], man:tlsrpt_strerror[3],
       man:tlsrpt_error_code_is_internal[3]

AUTHOR
       Boris Lohner

tlsrpt_cancel_delivery_request    2026-09-01 TLSRPT_CANCEL_DELIVERY_REQUEST(3)