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 |