ATMI C Function Reference
tpcancel()
—Routine for canceling a call descriptor for outstanding reply.
#include <atmi.h>
int tpcancel(int cd)
tpcancel()
cancels a call descriptor, cd
, returned by tpacall()
. It is an error to attempt to cancel a call descriptor associated with a transaction.
Upon success, cd
is no longer valid and any reply received on behalf of cd
will be silently discarded.
In a multithreaded application, a thread in the TPINVALIDCONTEXT
state is not allowed to issue a call to tpcancel()
.
Upon failure, tpcancel()
returns -1 and sets tperrno
to indicate the error condition.
Upon failure, tpcancel()
sets tperrno
to one of the following values:
cd
() is associated with the caller's transaction. cd
remains valid and the caller's current transaction is not affected.