TUPConnectStatusReq

Sends connection status information to the far exchange during the connection establishment phase.

Prototype

DWORD NMSAPI TUPConnectStatusReq ( CTAHD ctahd, U8 board, TupSpId spId, TupInstId suInstId, TupInstId spInstId, CirIdx circuit, TupCnStEvnt *conStEvnt, U8 evntType)

Argument

Description

ctahd

Natural Access handle.

board

TX board number.

spId

TUP service access point.

suInstId

Service user instance ID.

spInstId

Service provider instance ID.

circuit

Circuit index with which this message is associated.

conStEvnt

Pointer to the caller's connect status event structure containing all parameters (IEs) included in the message to the far exchange.

evntType

Identifies the type of message sent to the far exchange. Refer to the Details section for a list of valid message types.


Return values

Return value

Description

TUP_SUCCESS

 

TUP_INVBOARD

board is out of range.

TUP_NOTBOUND

Application failed to open the TUP service.

TUP_OSERROR

Error occurred accessing the driver.

TUP_UNKEVENT

Unrecognized event type requested.


Details

The connection status information can be address complete, progress, information request, and so on. For more information, refer to Establishing connections.

The following table lists the valid message types:

Message type

Description

TUPADDRCMPLT

Address complete (ACM)

TUPFRWDTRSFR

Forward transfer (FOT)

TUPINFORMATION

Information (GSM response to GRQ)

TUPINFORMATREQ

Information request (GRQ)

TUPSUBSADDR

Subsequent address message (SAM, SAO)

TUPMALICIOUS

Malicious call signal (MAL)

TUPREANSWER

Re-answer signal (RAN)

TUPCALLCLEAR

Calling party clear (CCL)

TUPAUTOCONG

Auto-congestion message (ACC)

TUPMETERPULSE

Metering pulse message (MPM) - China only

TUPOPERATOR

Operator signal (OPR) - China only