Resets the TCAP inactivity timer.
DWORD TCAPRetainTrans ( CTAHD ctahd, S16 spId, TcapTransInfo *pTinfo)
|
Argument |
Description |
|
ctahd |
Context handle returned by ctaCreateContext. |
|
spId |
TCAP service access point ID. |
|
pTinfo |
Pointer to the address of the caller's TcapTransInfo buffer specifying the general characteristics of the transaction message. |
|
Return value |
Description |
|
TCAP_SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
Natural Access handle is invalid, or an invalid message buffer has been used. |
|
CTAERR_DRIVER_SEND_FAILED |
Message buffer was not sent to the board. Call TCAPGetApiStats and check the txLastErr field to find the error. |
|
CTAERR_INVALID_HANDLE |
Natural Access handle is invalid. |
|
CTAERR_OUT_OF_MEMORY |
TCAP service queue is full and another request could not be queued to the TCAP layer. |
This function is normally called after an inactivity timeout indication was received for an open transaction. If the application wants to keep the transaction open, a call to TCAPRetainTrans causes the inactivity timer to be reset. When the inactivity timer expires again, another inactivity timeout indication is received.
The inactivity timer value can be modified by setting a non-zero value in the inactvTimer field in the TcapTransInfo structure. If set to zero, the inactivity timer value remains the same.