Sends user data associated with an established connection to the far end point.
DWORD SCCPDataRqst ( CTAHD ctahd, SccpConnId *connId, SccpDataRqst *dataRqst)
|
Argument |
Description |
|
ctahd |
Natural Access handle returned by ctaCreateContext. |
|
connId |
Pointer to the connection ID. |
|
dataRqst |
Pointer to the caller's data request message structure containing all parameters and user data to be included in the message to the far endpoint. |
|
Return value |
Description |
|
SCCP_SUCCESS |
|
|
SCCPERR_OVERRUN |
Message generated by this request exceeds the maximum allowed size. |
|
SCCPERR_RESOURCES |
Number of available buffers is exhausted. |
|
CTAERR_BAD_ARGUMENT |
One or more arguments are invalid. |
|
CTAERR_DRIVER_SEND_FAILED |
Error occurred accessing the CPI driver. Call SCCPGetStats to obtain the error code. The error code is in the failTxErr field of the SccpStats structure. The CPI error codes are listed in the txcpi.h include file. |
|
CTAERR_INVALID_CTAHD |
Natural Access handle is invalid. |
Based on the service class in use on the specified connection, the SCCP layer generates either data form 1 (DT1) or data form 2 (DT2) packets, including any necessary segmentation.
The maximum length of the data field included in the SccpDataRqst structure is MAX_DATA_SZ bytes. The SCCP layer performs any necessary segmentation based on the maximum allowable packet size for the chosen network service access point.
Refer to Transferring connection-oriented data for more information.