Sends connection status information to the far exchange during the connection establishment phase.
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 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. |
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 |