Requests establishment of an SCCP connection.
DWORD SCCPConnectRqst ( CTAHD ctahd, SccpConnId *connId, SccpConnRqst *connRqst)
|
Argument |
Description |
|
ctahd |
Natural Access handle returned by ctaCreateContext. |
|
connId |
Pointer to the connection ID. |
|
connRqst |
Pointer to the caller's connect event structure containing all parameters relevant to establishing this connection. |
|
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. |
If the SCCP layer cannot successfully initiate the outgoing connection request (for example, due to network congestion), it returns an asynchronous released indication message to the application with the cause value coded with the reason for the failure.
Refer to Establishing connections for more information.