Sends a transaction message request to the TCAP layer.
DWORD TCAPTransRqst ( CTAHD ctahd, S16 spId, U8 *pMessage)
|
Argument |
Description |
|
ctahd |
Context handle returned by ctaCreateContext. |
|
spId |
TCAP SAP ID to which this transaction belongs. |
|
pMessage |
Pointer to the address of the caller's transaction message that was constructed with TCAPInitTrans, and optionally, TCAPAddComp. |
|
Return value |
Description |
|
TCAP_SUCCESS |
|
|
TCAP_PARAM |
Message buffer is not valid. Call TCAPInitTrans using the message buffer before you call TCAPTransRqst. |
|
CTAERR_BAD_ARGUMENT |
Natural Access handle is invalid, or an invalid message buffer has been used. |
|
CTAERR_BAD_SIZE |
Message buffer is too large to be sent. |
|
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. Refer to TCAP service congestion for more information. |
Successful completion of this function implies that the request was successfully queued to the TCAP layer. The request can subsequently be rejected by the TCAP layer. If the request is rejected, the application receives a status event indication (TCAP_EVENT_STA_IND) message from the TCAP layer. If the request cannot be delivered by the SCCP layer, the application receives a notify event indication (TCAP_EVENT_NOT_IND) message from the TCAP layer.
The transaction message must have been constructed using TCAPInitTrans, and optionally TCAPAddComp, prior to being sent.