ms_delxtdcon( )

---

Cautions | Errors | Example | See Also

Name:	int ms_delxtdcon (devh, xid)
Inputs:	int devh	MSI board device handle
	int xid	extended connection identifier
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	Extended Connection
Mode:	synchronous
Platform:	Springware

Description

The ms_delxtdcon( ) function deletes an extended connection. The connection extender is removed on successful completion of this function. Calling this function does not affect the integrity of the connection. The two parties will still remain in a connection.

Parameter	Description
devh	the MSI board device handle
xid	the extended connection identifier number

Notes:

1. It is the responsibility of the application to do an ms_unlisten( ) for the connection extender.
2. Calling this function frees three resources.

Cautions

This function fails when:

• The device handle specified is invalid
• The device is not an MSI board
• The connection ID is invalid

Errors

If this function returns -1 to indicate failure, obtain the reason for the error by calling the SRL standard attribute function ATDV_LASTERR( ) or ATDV_ERRMSGP( ) to retrieve either the error code or a pointer to the error description, respectively.

Refer to the error type tables found in Chapter 5, "Error Codes". Error defines can be found in dtilib.h or msilib.h.

Example

#include <windows.h>          /* For Windows applications only */
#include <errno.h>
#include "srllib.h"
#include "dtilib.h"
#include "msilib.h"
int  dev1;                    /* Device handle for board */
int  xid;                     /* Connection ID */
SC_TSINFO   tsinfo;           /* Time slot information structure */  
/* Start System */
/*
 * Assume that there is an extended connection between a
 * station and a time slot. xid is obtained from the previous
 * extended connection.
*/  
/*
 *   Continue processing
 */  
/*
 * Do an unlisten for the connection extender if it is a external
 * party
 */  
/*
 * Delete the extended connection
 */
if (ms_delxtdcon(dev1,xid) == -1) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/*
 * Continue processing
 */  

See Also

• ms_chgxtder( )
• ms_estxtdcon( )

Click here to contact Telecom Support Resources