SCCPUDataRqst

Sends a datagram to the destination specified in the calledPty parameter of the SCCPUDataRqst message.

Prototype

DWORD SCCPUDataRqst ( CTAHD ctahd, S16 spId, SccpUdataRqst *dataRqst)

Argument

Description

ctahd

Natural Access handle returned by ctaCreateContext.

spId

SCCP service access point.

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 end point.


Return values

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.


Details

Based on the service class requested and the size of the data field, the SCCP layer generates either unitdata (UDT) or extended unitdata (XUDT) packet(s).

The maximum length of the data field included in the SccpUdataRqst structure is MAX_DATA_SZ bytes.

Refer to Transferring connectionless data for more information.