ms_setcde( )

---

Cautions | Errors | Example | See Also

Name:	int ms_setcde (devh, confID, cdt)
Inputs:	int devh	MSI device handle
	int confID	conference identifier
	MS_CDT *cdt	pointer to an MS_CDT structure
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	Conference Management
Mode:	synchronous
Platform:	DI, Springware

Description

The ms_setcde( ) function changes the attributes of a party in an existing conference.

Note: If the party attributes of more than one party are to be set, this function must be called multiple times.

Parameter	Description
devh	the MSI device handle
confID	the conference identifier number
cdt	pointer to the conference descriptor table. See the MS_CDT data structure page for details.

Cautions

This function fails when:

• The device handle specified is invalid
• The device is not connected to the TDM bus

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"  
#define   NUM_PARTIES   2  
int dev1;                   /* Board dev descriptor variables */
int chdev2;                 /* Channel dev descriptor */
MS_CDT cdt[NUM_PARTIES];    /* Conf. desc. table */
int confID;                 /* Conf. ID */  
/* Open board 1 device */
if ((dev1 = ms_open("msiB1",0)) == -1) {
    printf( "Cannot open MSI B1: errno=%d", errno);
    exit(1);
}  
/* Open board 1, channel 2 device */
if ((chdev2 = ms_open("msiB1C2",0) == -1) {
    printf("Cannot open MSI B1, C2. errno = %d", errno);
    exit(1);
}  
/*
 *
 * Continue processing
 *
 */  
/* Set up CDT structure */
cdt[0].chan_num = 2;
cdt[0].chan_sel = MSPN_STATION;
cdt[0].chan_attr = MSPA_COACH;  
cdt[1].chan_num = 1;
cdt[1].chan_sel = MSPN_TS;
cdt[1].chan_attr = MSPA_PUPIL;  
/* Establish conference */
if (ms_estconf(dev1, cdt, NUM_PARTIES, MSCA_ND, &confID) != 0) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/*
 *
 * Continue processing
 *
 */  
/* Now change the attribute of MSI Station 2 */
cdt[0].chan_num = 2;
cdt[0].chan_sel = MSPN_STATION;
cdt[0].chan_attr = MSPA_NULL;  
if((ms_setcde(dev1, confID, cdt)) == -1) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/*
 * Continue Processing
 *
 */  

See Also

• ms_addtoconf( )
• ms_estconf( )
• ms_getcde( )

Click here to contact Telecom Support Resources